返回 Bug 清单
BUG-0005project-03高已修复docker-registry
Docker TLS 握手超时（腾讯云镜像）
发现：2026-09-30验证：2026-10-31置信度：85%
症状
`docker compose up --build` 时报错：
```
failed to solve: python:3.11-slim-bookworm: failed to resolve source metadata for
docker.io/library/python:3.11-slim-bookworm: net/http: TLS handshake timeout
```
（[cursor_202606072237.md: Sections 12-13](file://d:/ai_mirror/cursor_202606072237.md)）
根因
Docker 配置了腾讯云镜像 `mirror.ccs.tencentyun.com` 作为 `registry-mirrors`，拉取 `python:3.11-slim-bookworm` 时 TLS 握手超时。同时 Dockerfile 指定了 `python:3.11-slim-bookworm`，而本机已有 `python:3.12-slim` 和 `redis:7-alpine`。
修复方案
1. `Dockerfile.cpu` 改为 `FROM python:3.12-slim`（与本机缓存一致）
2. 新增 `docker-compose.offline.yml` — 离线 Compose（`pull_policy=never`）
3. 新增 `docker-compose.redis-only.yml` — 仅启动 Redis
4. 新增 `scripts/start-dev-local.ps1` — 一键本地开发启动脚本
5. README 添加「方案 B2（推荐 Docker 用户，零构建）」说明
修复命令
1. `Dockerfile.cpu` 改为 `FROM python:3.12-slim`（与本机缓存一致）
2. 新增 `docker-compose.offline.yml` — 离线 Compose（`pull_policy=never`）
3. 新增 `docker-compose.redis-only.yml` — 仅启动 Redis
4. 新增 `scripts/start-dev-local.ps1` — 一键本地开发启动脚本
5. README 添加「方案 B2（推荐 Docker 用户，零构建）」说明错误签名
failed to solve: python:3.11-slim-bookworm: failed to resolve source metadata for
docker.io/library/python:3.11-slim-bookworm: net/http: TLS handshake timeout技术信息
来源项目
project-03
涉及文件
docker-compose.yml, Dockerfile.cpu, docker-compose.offline.yml`（新增） +1
标签
docker-registry, project-03