Docker拉取镜像部分成功部分失败的解决方案

 问题背景

部署 Zitadel 时，使用官方提供的 getting-started-with-zitadel.sh 脚本，脚本会拉取多个 Docker 镜像，比如：

• ghcr.io/zitadel/zitadel
• docker.io/library/caddy
• netbirdio/** 等

问题表现

在执行过程中，有些镜像可以拉取成功，有些会报如下错误：

Error response from daemon: Get "https://registry-1.docker.io/v2/": 
net/http: request canceled while waiting for connection 
(Client.Timeout exceeded while awaiting headers)

观察结果是：

同时，我们很早就配置了一些 Docker Hub 镜像加速器（如阿里云，腾讯云，DaoCloud 等），这也是为什么有些镜像能顺利拉取，有些却不能的原因之一。

因为镜像加速器仅能加速“Docker Hub 官方镜像”，如 library/nginx 或 docker.io/library/caddy，而像 netbirdio/* 这种非官方项目的镜像并不在加速器白名单内，因此仍然会拉取失败。

初步排查

网络本身没有问题

• ping registry-1.docker.io 正常
• curl https://registry-1.docker.io/v2/ 正常
• docker login 也没有任何异常

但 Docker 拉取仍旧失败

通过多次测试发现，Docker 有些镜像拉得飞快，有些镜像卡死或超时，尤其是 docker.io/netbirdio 相关的镜像。

这时开始怀疑：

可能和代理有关

解决思路：配置 Docker 的守护进程代理

平时我们习惯配置终端代理，例如：

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

但实际上：

Docker 守护进程（dockerd）是独立运行的，它不会继承当前 shell 的代理环境变量！

解决方案：配置 Docker 的 systemd 代理

• 创建代理配置目录（如不存在）：

sudo mkdir -p /etc/systemd/system/docker.service.d

• 创建代理配置文件：

sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf

• 写入以下内容（根据你实际代理修改）：

[Service]
Environment="HTTP_PROXY=http://127.0.0.1:7890"
Environment="HTTPS_PROXY=http://127.0.0.1:7890"
Environment="NO_PROXY=localhost,127.0.0.1,.corp"

• 应用配置并重启 Docker：

sudo systemctl daemon-reexec
sudo systemctl daemon-reload
sudo systemctl restart docker

• 验证代理是否生效：

sudo systemctl show --property=Environment docker

输出应该包含你刚才设置的代理环境变量。

最终结果

重启 Docker 后再次运行部署脚本：

• 所有镜像（包括 netbirdio）都能成功拉取
• 部署流程顺利走完

总结

经验教训

• Docker CLI 和 Docker 守护进程环境是 两套东西，网络设置互不影响
• 如果你使用代理加速访问 Docker Hub，务必同步设置到 系统服务级别
• 部署复杂服务时，像 Zitadel 这类一键脚本可能集成很多镜像，尽早配置好代理 可避免不必要的卡顿
• 配置镜像加速器虽然有用，但仅限于部分镜像。像 netbirdio、ghcr.io 上的镜像，加速器是无法覆盖的，因此守护进程代理是更通用的做法
• Docker 官方解决文档

以上就是Docker拉取镜像部分成功部分失败的解决方案的详细内容，更多关于Docker拉取镜像部分成功部分失败的资料请关注脚本之家其它相关文章！