前言

最近在使用 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，可以打印更多日志方便后续排查。

---

四、完整操作流程总结

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

sudo nano /etc/docker/daemon.json

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

2. 重启 Docker：

sudo systemctl daemon-reexec
sudo systemctl restart docker

1. 验证是否生效：

docker info

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

---

五、额外建议

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

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

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

---

六、写在最后

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

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