Docker拉取Python官方镜像超时导致构建失败求助

问题本质 #

从错误日志来看，构建失败并非Dockerfile的问题，核心是拉取python:3.8-slim-buster基础镜像时，无法连接Docker官方的Cloudflare CDN节点，出现TCP连接超时，属于网络层面的故障。

解决步骤 #

1. 排查本地网络连通性 #

• 测试目标节点连通性：执行以下命令，确认是否能正常访问CDN节点

  ping 104.18.123.25
  

  或尝试访问具体资源地址：

  curl -v https://production.cloudflare.docker.com/registry-v2/docker/registry/v2/blobs/sha256/cf/cf7d11e02afd21125c5378d971bc42cfed2b697d7c116b14eed0baad617839da/data?verify=1687069048-Wqw%2FLtaBudeh5Szh3s0QeRVV6q0%3D
  

• 切换网络环境（比如手机热点），排除公司/家庭网络的防火墙、代理限制。

2. 清理Docker缓存后重试 #

• 清理所有无用镜像、缓存：

  docker system prune -a
  

• 或单独删除可能损坏的python镜像缓存，重新拉取：

  docker rmi python:3.8-slim-buster
  docker pull python:3.8-slim-buster
  

3. 配置国内Docker镜像源 #

若官方源持续无法访问，可配置国内镜像源绕过Cloudflare节点：

• Linux系统：编辑/etc/docker/daemon.json，添加国内镜像地址（示例为阿里云加速源，需替换为自己的地址）：

  {
    "registry-mirrors": ["https://xxxx.mirror.aliyuncs.com"]
  }
  

  配置完成后重启Docker服务：

  systemctl restart docker
  

• Windows/macOS系统：打开Docker Desktop，进入设置-Docker Engine，添加上述registry-mirrors配置后重启Docker。

4. 手动拉取镜像再构建 #

先确保基础镜像已成功拉取到本地，再执行构建命令：

docker pull python:3.8-slim-buster
docker build .

内容的提问来源于stack exchange，提问作者Youshikyou