返回 Bug 清单
BUG-0015project-03中已修复docker-proxy

Docker 离线 Compose 构建 apt-get 失败

发现:2026-09-30验证:2026-10-31置信度:85%

症状

([cursor_202606072237.md: Section 27](file://d:/ai_mirror/cursor_202606072237.md)):`docker compose -f docker-compose.offline.yml up --build` 在 Dockerfile 的 `apt-get` 阶段卡死,日志显示 `TLS handshake timeout` 或因代理 `127.0.0.1:10809` 的网络请求阻塞。

根因

本机配置了 Clash 代理 `127.0.0.1:10809` + 腾讯云 Docker 镜像源,两者组合导致 Docker 容器内 `apt-get` 的网络请求在代理和镜像源之间产生冲突。不是项目代码问题,而是本机网络环境与 Docker 的兼容性问题。

修复方案

1. 新增 `docker-compose.prebuilt.yml` — 使用本机已有 `python:3.12-slim` 镜像,`pull_policy=never`,零构建启动 2. README 添加「方案 B2(推荐 Docker 用户,零构建)」说明 3. 确认本机已有 `python:3.12-slim` 和 `redis:7-alpine`

修复命令

1. 新增 `docker-compose.prebuilt.yml` — 使用本机已有 `python:3.12-slim` 镜像,`pull_policy=never`,零构建启动
2. README 添加「方案 B2(推荐 Docker 用户,零构建)」说明
3. 确认本机已有 `python:3.12-slim` 和 `redis:7-alpine`

错误签名

([cursor_202606072237.md: Section 27](file://d:/ai_mirror/cursor_202606072237.md)):`docker compose -f docker-compose.offline.yml up --build` 在 Dockerfile 的 `apt-get` 阶段卡死,日志显示 `TLS handshake timeout` 或因代理 `127.0.0.1:10809` 的网络请求阻塞。

技术信息

来源项目

project-03

涉及文件

docker-compose.offline.yml`(新增), docker-compose.prebuilt.yml`(新增), README.md

标签

docker-proxy, project-03