网站导航
> 技术文档 > 【血泪经验】Docker 拉取镜像超时竟是这个原因！配置镜像加速器还不够？_docker pull拉取镜像超时

【血泪经验】Docker 拉取镜像超时竟是这个原因！配置镜像加速器还不够？_docker pull拉取镜像超时

网友: 技术文档 2025-07-26 20:53:13

前言

最近在使用 Docker 拉取镜像时，遇到了一连串令人抓狂的超时报错：

ERROR: Get https://registry-1.docker.io/v2/: net/http: request canceled while waiting for connection

这问题听起来熟悉吗？网上一搜，大家都建议你配置国内镜像源。但我试了好几个，照做之后依然拉！不！动！，仿佛镜像仓库从地球被搬到了火星。

于是，我花了一整天翻资料、试配置，最终完美解决。今天就来详细分享这趟“排雷”过程，以及一个隐藏的关键点，希望能帮你彻底解决 Docker 拉取镜像超时的问题。

一、问题现象

在执行如下命令拉取镜像时：

docker pull nginx

Docker 会尝试从默认仓库 https://registry-1.docker.io/v2/ 拉取，但出现了下面这个报错：

Get https://registry-1.docker.io/v2/: net/http: request canceled while waiting for connection

这个错误大概率是因为网络问题，连接 Docker 官方仓库超时。国内访问 Docker Hub 一直不算稳定，加速器成了刚需。

二、常规解决方案：配置国内镜像源

大部分教程都建议配置 /etc/docker/daemon.json 文件（没有就新建一个），内容如下：

{ \"registry-mirrors\": [ \"https://docker.1panel.live\", \"https://dc.j8.work\", \"https://docker.m.daocloud.io\", \"https://dockerproxy.com\", \"https://docker.mirrors.ustc.edu.cn\", \"https://docker.nju.edu.cn\" ]}

配置完之后重启 Docker：

systemctl daemon-reexecsystemctl restart docker

理论上应该可以了……结果还是超时！

三、深入排查：这些隐藏配置你加了吗？

在我反复尝试多种镜像源无果之后，我开始怀疑：

是不是仅仅配置 registry-mirrors 不够？

答案是：是的！

我最终使用了下面这份更全面的配置，才真正解决问题：

{ \"registry-mirrors\": [ \"https://docker.registry.cyou\", \"https://docker-cf.registry.cyou\", \"https://dockercf.jsdelivr.fyi\", \"https://docker.jsdelivr.fyi\", \"https://dockertest.jsdelivr.fyi\", \"https://mirror.aliyuncs.com\", \"https://dockerproxy.com\", \"https://mirror.baidubce.com\", \"https://docker.m.daocloud.io\", \"https://docker.nju.edu.cn\", \"https://docker.mirrors.sjtug.sjtu.edu.cn\", \"https://docker.mirrors.ustc.edu.cn\", \"https://mirror.iscas.ac.cn\", \"https://docker.rainbond.cc\", \"https://do.nark.eu.org\", \"https://dc.j8.work\", \"https://gst6rzl9.mirror.aliyuncs.com\", \"https://registry.docker-cn.com\", \"http://hub-mirror.c.163.com\", \"http://mirrors.ustc.edu.cn/\", \"https://mirrors.tuna.tsinghua.edu.cn/\", \"http://mirrors.sohu.com/\" ], \"insecure-registries\": [ \"registry.docker-cn.com\", \"docker.mirrors.ustc.edu.cn\" ], \"debug\": true, \"experimental\": false}

几个关键点必须解释清楚：

✅ 镜像源要够多

不是所有镜像都适用于你当前的网络环境，多加几个备用，不仅速度快，还能防止单点故障。

✅ 添加 insecure-registries

有些镜像源不支持 HTTPS，或你所在的网络环境中存在中间人干扰，Docker 默认不会信任这些源。通过加上 \"insecure-registries\"，你明确告诉 Docker：“我信它！”

✅ debug 和 experimental 参数

这两个不是解决问题的核心，但建议开启 debug: true，可以打印更多日志方便后续排查。

四、完整操作流程总结

  1. 编辑或新建 /etc/docker/daemon.json：

sudo nano /etc/docker/daemon.json

  1. 粘贴上面的配置内容。

  2. 重启 Docker：

sudo systemctl daemon-reexecsudo systemctl restart docker

  1. 验证是否生效：

docker info

在输出中找到 \"Registry Mirrors\" 字段，如果配置的镜像源都显示出来了，就说明生效了。

五、额外建议

  • 科学上网优先：如果你有稳定的代理，其实使用官方镜像源也没问题。

  • 测试镜像加速效果：可以用 curl 命令去访问镜像源，看响应速度。

  • 定期更新镜像源列表：有些镜像站可能过期、下线，保持新鲜有助于稳定。

六、写在最后

Docker 镜像拉取超时这个坑，真的是国内开发者的“入门之痛”。希望这篇文章可以帮你少踩点坑。如果你也被这个问题困扰过，欢迎点赞、转发、收藏，或者评论区分享你的解决方案！

你的一个小操作，是我持续创作的最大动力 ❤️

网络标签：

相关问题