Docker 拉取镜像超时解决方案
在执行 docker pull nginx 等命令时,若遇到如下报错:
ERROR: 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:
sudo systemctl daemon-reexec
sudo systemctl restart docker
理论上应该可以解决,但有时依然会超时。
深入排查:隐藏配置项
如果仅配置 registry-mirrors 无效,需要检查以下隐藏配置:
- 镜像源数量:不同网络环境下可用的镜像源不同,建议添加多个备用以防单点故障。
- insecure-registries:部分镜像源不支持 HTTPS 或存在中间人干扰,需明确告诉 Docker 信任它们。
- Debug 模式:开启
debug: true可打印更多日志方便排查。
推荐配置如下:
{
"registry-mirrors": [
"https://docker.registry.cyou",
"https://docker-cf.registry.cyou"


