Docker Windows配置国内镜像源过程

在 Windows 下配置 Docker 使用国内镜像源可显著提升镜像下载速度，解决因网络限制导致的拉取缓慢或失败问题。

以下是两种常用配置方法（任选其一即可）：

方法一：通过 Docker Desktop 图形界面配置

步骤：

打开设置

• 右键点击任务栏 Docker 图标 → 选择 “Settings”。

修改 Docker Engine 配置

• 左侧菜单选择 “Docker Engine”。
• 在右侧 JSON 配置区添加或修改 registry-mirrors 字段，填入国内镜像源地址（示例如下）：

{
  "registry-mirrors": [
    "https://mirror.ccs.tencentyun.com",    // 腾讯云
    "https://registry.docker-cn.com",       // Docker 中国官方
    "http://hub-mirror.c.163.com",          // 网易云
    "https://docker.mirrors.ustc.edu.cn"    // 中科大
  ]
}

提示：

• 推荐同时配置多个镜像源作为备份。
• 若使用阿里云，需先申请专属加速地址（替换为 https://<你的ID>.mirror.aliyuncs.com）。

保存并重启

• 点击 “Apply & Restart” 使配置生效。

方法二：直接修改配置文件daemon.json

步骤：

定位配置文件

• 打开文件资源管理器，访问路径：
• C:\Users\<你的用户名>\.docker\daemon.json
• （若文件不存在，请手动创建）。

编辑文件内容

• 添加以下配置（可自定义镜像源组合）：

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

重启 Docker 服务

• 任务栏右键 Docker 图标 → “Quit Docker Desktop”。
• 重新启动 Docker Desktop。

验证配置是否生效

执行以下命令检查镜像源状态：

docker info

在输出中查找 “Registry Mirrors” 部分，若显示已配置的镜像源地址，即表示成功。

速度测试：

docker pull nginx:latest  # 观察下载速度是否提升

常见问题解决

配置后无法拉取镜像

• 检查 JSON 格式是否正确（无多余逗号，引号为英文符号）。
• 尝试更换其他镜像源（部分源可能临时不可用）。
• 清理缓存：docker system prune -a。

重启 Docker Desktop 失败

• 删除 daemon.json 文件后重新配置。
• 重启操作系统或重装 Docker Desktop。

最佳实践建议

• 多镜像源备份：同时配置 3~4 个镜像源（如腾讯云、中科大、网易云），避免单点故障。
• 定期测试速度：用 time docker pull nginx 对比不同源，保留最快选项。
• 阿里云加速器：企业用户建议申请专属阿里云地址，稳定性更高。

通过上述配置，镜像下载速度通常可提升 3~5 倍。若需更详细的镜像源列表或故障排查，可参考 Docker 官方文档 或国内云服务商指南。

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。