这个错误：
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)
表示
Docker 无法连接到官方镜像仓库registry-1.docker.io
，通常是因为
网络问题
，尤其是在国内的服务器或网络环境下非常常见。
🔍 常见原因 国内访问 Docker Hub 极慢或被限流 未配置镜像加速器 DNS 问题 防火墙或代理限制 Docker 服务异常 ✅ 解决方案（推荐顺序） ✅ 方案 1：配置阿里云镜像加速器（最有效！
） 这是国内最稳定、最快的解决方案。
1. 获取加速器地址 访问： https://cr.console.aliyun.com/cn-hangzhou/instances/mirrors （登录阿里云账号） 你会看到一个专属加速地址，如：
https://xxxx.mirror.aliyuncs.com
2. 配置 Docker 使用镜像加速
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": ["https://xxxx.mirror.aliyuncs.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
🔁 替换
xxxx
为你的实际加速器 ID。
3. 验证是否生效
docker info
查看是否有：
Registry Mirrors:
https://xxxx.mirror.aliyuncs.com/
然后尝试拉取镜像：
docker pull hello-world
✅ 方案 2：使用其他公共镜像加速（备用） 如果阿里云不可用，可尝试：
{
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn",
"https://hub-mirror.c.163.com",
"https://mirror.baidubce.com"
]
}
⚠️ 注意：部分公共镜像可能不稳定或限速。
配置方法同上，修改
/etc/docker/daemon.json
后重启 Docker。
✅ 方案 3：检查网络和 DNS 1. 测试是否能解析
registry-1.docker.io
nslookup registry-1.docker.io
# 或
dig registry-1.docker.io
如果解析失败，可能是 DNS 问题。
2. 更换 DNS
sudo vi /etc/resolv.conf
添加：
nameserver 8.8.8.8
nameserver 114.114.114.114
保存后重试。
✅ 方案 4：检查是否在代理环境中 如果你在公司网络或使用了代理，Docker 可能需要配置代理。
为 Docker 服务配置代理
sudo mkdir -p /etc/systemd/system/docker.service.d
sudo tee /etc/systemd/system/docker.service.d/http-proxy.conf <<-'EOF'
[Service]
Environment="HTTP_PROXY=http://proxy.example.com:8080"
Environment="HTTPS_PROXY=http://proxy.example.com:8080"
Environment="NO_PROXY=localhost,127.0.0.1,docker.io"
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
替换
proxy.example.com:8080
为你的实际代理地址。
✅ 方案 5：重启 Docker 服务（临时问题） 有时是 Docker 守护进程卡住了：
sudo systemctl restart docker
✅ 方案 6：直接使用镜像仓库代理（高级） 如果你有私有镜像仓库（如 Harbor），可以配置为代理缓存：
{
"registry-mirrors": ["https://your-harbor.com"]
}
🚫 错误做法（不要做） ❌ 直接
ping registry-1.docker.io
来判断网络（ICMP 被禁用是正常的） ❌ 手动下载镜像再
docker load
（不现实） ❌ 修改
/etc/hosts
绑定 IP（IP 经常变） ✅ 验证是否修复
docker run hello-world
如果能正常拉取并运行，说明问题解决 ✅ 📌 总结 问题解决方案 拉取镜像超时✅ 配置阿里云镜像加速器DNS 解析失败✅ 更换为 8.8.8.8 或 114.114.114.114在代理环境✅ 配置 Docker 代理临时卡住✅ 重启 Docker 服务 💡 强烈建议所有国内用户配置阿里云镜像加速器 ，这是最稳定、最高效的解决方案。