Docker拉取镜像超时的原因分析与解决方法

前言

最近在使用 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
}

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

1.镜像源要够多

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

2.添加 insecure-registries

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

3.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 镜像拉取超时这个坑，真的是国内开发者的“入门之痛”。

到此这篇关于Docker拉取镜像超时的原因分析与解决方法的文章就介绍到这了,更多相关Docker拉取镜像超时内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论