最新说明:由于不可描述的原因,很多镜像源地址已经失效。

现在可以使用的镜像源地址:

  • https://docker-0.unsee.tech/

其他的,可以参考 目前国内可用Docker镜像源汇总(截至2025年3月) - CoderJia

以下是旧文:


在国内使用 Docker Desktop for Windows 时,由于网络原因,从默认的 Docker Hub 下载镜像可能会很慢。本教程将介绍如何配置国内镜像源,以提升镜像的下载速度。

常用的国内 Docker 镜像源

以下是一些常用的国内 Docker 镜像源地址:

  • 阿里云:https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
  • 腾讯云:https://mirror.ccs.tencentyun.com
  • 华为云:https://mirrors.huaweicloud.com/repository/docker-ce
  • 中科大:https://mirrors.ustc.edu.cn/docker-ce
  • 网易:https://mirrors.163.com/docker-ce

配置步骤

方法一:通过 Docker Desktop 界面配置

  1. 打开 Docker Desktop
  2. 点击右上角的设置图标(⚙️)
  3. 在左侧菜单中选择 “Docker Engine”
  4. 在右侧 JSON 配置中添加或修改 registry-mirrors 配置:
{
  "registry-mirrors": [
    "https://mirror.ccs.tencentyun.com",
    "https://mirrors.aliyun.com",
    "https://hub-mirror.c.163.com"
  ]
}
  1. 点击 “Apply & Restart” 按钮应用更改

方法二:直接修改配置文件

  1. 打开 Windows 资源管理器
  2. 导航到配置文件位置:%UserProfile%\.docker\daemon.json
  3. 如果文件不存在,创建新文件
  4. 添加或修改以下内容:
{
  "registry-mirrors": [
    "https://mirror.ccs.tencentyun.com",
    "https://mirrors.aliyun.com",
    "https://hub-mirror.c.163.com"
  ]
}
  1. 保存文件
  2. 重启 Docker Desktop

验证配置

配置完成后,可以通过以下命令验证镜像源是否配置成功:

docker info

在输出信息中,找到 Registry Mirrors 部分,如果显示了你配置的镜像源地址,说明配置成功。

使用阿里云镜像源

如果你想使用阿里云的镜像源,还可以申请专属加速器:

  1. 登录阿里云控制台
  2. 搜索 “容器镜像服务”
  3. 在左侧菜单选择 “镜像工具 > 镜像加速器”
  4. 获取你的专属加速器地址
  5. 将该地址添加到 registry-mirrors 配置中

常见问题

1. 配置后无法拉取镜像

如果配置镜像源后仍然无法拉取镜像,可以尝试以下解决方案:

  1. 检查网络连接
  2. 确保配置文件格式正确(JSON 格式)
  3. 重启 Docker Desktop
  4. 尝试使用其他镜像源

2. 重启 Docker Desktop 失败

如果重启 Docker Desktop 失败,可以:

  1. 检查配置文件语法
  2. 删除配置文件重新配置
  3. 重启计算机
  4. 重新安装 Docker Desktop

最佳实践

  1. 配置多个镜像源:建议配置多个镜像源作为备份,当某个镜像源不可用时可以自动切换

  2. 定期更新配置:镜像源地址可能会变更,建议定期检查和更新配置

  3. 选择最快的镜像源:可以通过简单的拉取测试,选择在你的网络环境下最快的镜像源

# 测试镜像源速度
time docker pull nginx:latest
  1. 清理本地缓存:如果遇到问题,可以尝试清理 Docker 的本地缓存
# 清理未使用的镜像、容器和网络
docker system prune -a

总结

配置国内镜像源是提升 Docker 使用体验的重要步骤。通过本教程的配置,你可以显著提高 Docker 镜像的下载速度。记住要选择稳定可靠的镜像源,并定期维护配置以确保最佳性能。

如果你在配置过程中遇到任何问题,可以参考上述的故障排除步骤,或查看 Docker 的官方文档获取更多帮助。