Docker Pull 问题解决方案

当遇到 Docker 无法 pull 镜像时，可以按照以下步骤排查和解决问题：

1. 检查网络连接

• 确认主机可以访问互联网
• 测试基础网络连接：ping 8.8.8.8
• 测试域名解析：nslookup registry-1.docker.io

2. 检查 Docker 服务状态

systemctl status docker  # Linux
# 或
service docker status

3. 更换镜像源（针对国内用户）

编辑或创建 /etc/docker/daemon.json 文件：

{
  "registry-mirrors": [
    "https://registry.docker-cn.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}

然后重启 Docker 服务：

systemctl restart docker

4. 检查 DNS 设置

编辑 /etc/docker/daemon.json 添加 DNS 配置：

{
  "dns": ["8.8.8.8", "114.114.114.114"]
}

5. 查看详细错误信息

使用 --debug 参数获取更多信息：

docker --debug pull [镜像名]

6. 常见错误及解决方案

错误1: "net/http: TLS handshake timeout"

• 原因：网络连接问题
• 解决方案：
  • 检查防火墙设置
  • 尝试更换网络环境
  • 增加超时时间：docker pull --timeout=600 [镜像名]

错误2: "Error response from daemon: Get https://registry-1.docker.io/v2/: net/http: request canceled"

• 原因：Docker Hub 限速或网络问题
• 解决方案：
  • 使用代理
  • 更换镜像源
  • 购买 Docker Hub 订阅解除限速

错误3: "unauthorized: authentication required"

• 原因：需要登录
• 解决方案：

docker login

7. 其他尝试

• 清除 Docker 缓存：

docker system prune

• 检查磁盘空间：df -h
• 检查 Docker 版本并考虑升级

如果以上方法都无法解决，请提供具体的错误信息以便进一步诊断。