前言
最近在使用 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-reexec
systemctl 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，可以打印更多日志方便后续排查。
四、完整操作流程总结
编辑或新建 /etc/docker/daemon.json：
sudo nano /etc/docker/daemon.json
粘贴上面的配置内容。
重启 Docker：
sudo systemctl daemon-reexec
sudo systemctl restart docker
验证是否生效：
docker info
在输出中找到 "Registry Mirrors" 字段，如果配置的镜像源都显示出来了，就说明生效了。
五、额外建议
-
科学上网优先：如果你有稳定的代理，其实使用官方镜像源也没问题。
-
测试镜像加速效果：可以用 curl 命令去访问镜像源，看响应速度。
-
定期更新镜像源列表：有些镜像站可能过期、下线，保持新鲜有助于稳定。
六、写在最后
Docker 镜像拉取超时这个坑，真的是国内开发者的“入门之痛”。希望这篇文章可以帮你少踩点坑。如果你也被这个问题困扰过，欢迎点赞、转发、收藏，或者评论区分享你的解决方案！
你的一个小操作，是我持续创作的最大动力 ❤️
