Docker 国内镜像拉取报错解决方案

当使用 Docker 从国内镜像拉取镜像时遇到报错，可以尝试以下解决方案：

1. 使用国内镜像加速器

配置 Docker 国内镜像源

1. 编辑或创建 Docker 配置文件：

   sudo mkdir -p /etc/docker
   sudo tee /etc/docker/daemon.json <<-'EOF'
   {
    "registry-mirrors": [
      "https://docker.mirrors.ustc.edu.cn",
      "https://hub-mirror.c.163.com",
      "https://registry.docker-cn.com",
      "https://mirror.baidubce.com"
    ]
   }
   EOF
   

2. 重启 Docker 服务：

   sudo systemctl daemon-reload
   sudo systemctl restart docker
   

2. 常见国内镜像源地址

• 中科大镜像：https://docker.mirrors.ustc.edu.cn
• 网易镜像：https://hub-mirror.c.163.com
• 阿里云镜像：需登录阿里云容器镜像服务获取专属加速地址
• 百度云镜像：https://mirror.baidubce.com

3. 阿里云镜像加速器配置（推荐）

1. 登录阿里云容器镜像服务：https://cr.console.aliyun.com
2. 获取专属加速器地址
3. 配置到 /etc/docker/daemon.json

4. 其他解决方案

检查网络连接

ping docker.mirrors.ustc.edu.cn

检查 DNS 设置

cat /etc/resolv.conf

临时使用代理（如有）

export http_proxy="http://your-proxy-ip:port"
export https_proxy="http://your-proxy-ip:port"

直接指定镜像源拉取

docker pull registry.cn-hangzhou.aliyuncs.com/library/镜像名:版本

5. 常见错误及解决

证书错误

sudo mkdir -p /etc/docker/certs.d/docker.mirrors.ustc.edu.cn
# 将证书放入上述目录

速率限制

• 尝试更换不同的镜像源
• 登录 Docker Hub 账号后再拉取

镜像不存在

• 检查镜像名称和标签是否正确
• 尝试不加标签拉取最新版本

如果问题仍未解决，请提供具体的错误信息以便进一步诊断。