开发者网络 · Docker
主词：Docker pull超时
2026 国内 Docker 镜像加速与 Daemon 代理配置实战指南
全面解决 docker pull 频繁 connection timeout、Docker Hub 无法访问的问题：daemon.json 代理配置、国内镜像源替换与 Dockerfile 构建代理实战。
容器架构组 发布：2026-08-16 核验：2026-08-19
解决 docker pull 超时最彻底稳定的方式是在 Docker Daemon 层面挂载本地代理端口。配置步骤：在 Linux 下编辑 `/etc/systemd/system/docker.service.d/http-proxy.conf` 或在 Windows/macOS Docker Desktop 设置中直接填入 `HTTP_PROXY=http://127.0.0.1:7890` 并重启 Docker 服务。
一、Docker 守护进程 (Daemon) 代理配置（Linux 平台）
步骤 1：创建 systemd 代理配置文件
sudo mkdir -p /etc/systemd/system/docker.service.d
sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf步骤 2：写入代理环境变量（根据本地代理端口调整）
[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,docker-registry.somecorporation.com,.corp"步骤 3：重载 systemd 守护进程并重启 Docker
sudo systemctl daemon-reload
sudo systemctl restart docker步骤 4：验证代理是否生效
docker info | grep -i proxy如果输出包含刚刚设置的 HTTP_PROXY 与 HTTPS_PROXY，即可顺畅执行 docker pull ubuntu 或 docker pull node:latest！
二、Windows 与 macOS Docker Desktop 极简图形化配置
- 打开 Docker Desktop 设置界面（右上角 ⚙️ 齿轮图标）；
- 进入 『Resources』 $\to$ 『Proxies』；
- 勾选 『Manual proxy configuration』；
- 在 Web Server (HTTP) 与 Secure Web Server (HTTPS) 中填入：
http://127.0.0.1:7890（或你的代理软件本地监听端口）；
- 点击右下角 『Apply & restart』 即可立即生效。
容器加速
查看开发者专属机场 需要大带宽、拉取 Docker 镜像极速稳定的专线节点？
精选提供千兆海外直通带宽的开发者友好机场推荐。
建议下一步 阅读 GitHub 访问与 Git 代理加速指南
进入 解决 Git Clone 慢与 SSH 密钥配置