当使用docker pull或docker run时遇到net/http: request canceled while waiting for connection的报错，说明Docker客户端在访问Docker Hub时出现网络连接问题。可以不用挂加速器也能解决，linux不好用clash。以下是经过验证的方法（感谢轩辕镜像）

---

故障现象

执行Docker命令时提示：

docker: Error response from daemon: Get "https://registry-1.docker.io/v2/": 
net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)

---

错误根源分析

1. 网络访问限制
   Docker Hub（registry-1.docker.io）位于海外服务器，部分地区/网络环境可能受限制

2. DNS解析失败
   默认域名解析服务无法正确解析Docker仓库地址

3. 长距离网络延迟
   跨国网络传输容易导致连接超时（默认Docker客户端超时时间为30秒）

---

解决方案：配置镜像加速器

步骤一：设置Registry Mirror

# 创建/修改配置文件（注意备份原文件）
sudo vim /etc/docker/daemon.json# 录入以下内容（关键配置）
{"registry-mirrors": ["https://docker.1ms.run","https://docker.xuanyuan.me",]
}

（操作前建议通过curl -I https://docker.xuanyuan.me/v2/验证镜像地址可达性）

步骤二：应用配置并重启服务

# 重载守护进程配置
sudo systemctl daemon-reload# 完全重启docker服务
sudo systemctl restart docker# 验证配置生效
docker info | grep "Registry Mirrors" -A 2

---

测试优化技巧

1 网络诊断命令

# 查看容器网络路由
docker run --rm alpine ping -c 4 docker.com# DNS检测
docker run --rm busybox nslookup registry-1.docker.io

---

常见问题排查

1. 配置文件格式错误
   JSON格式错误会导致Docker启动失败，可通过sudo journalctl -u docker.service查看日志

2. 镜像源认证需求
   部分镜像源（如阿里云镜像）需注册后获取专属加速地址

3. 持续超时问题

   # 检查防火墙规则
   sudo iptables -L -n# 尝试指定IPv4强制访问
   echo '{"ipv6": false}' | sudo tee /etc/docker/daemon.json
   

---

配置示意图