最新说明:由于不可描述的原因,很多镜像源地址已经失效。以下地址于 2026 年 10 月 25 日在国内网络实测(registry API + 完整 docker pull 双重验证):

  • https://docker.1ms.run(最快,hello-world 完整拉取约 5.5 秒)
  • https://docker.m.daocloud.io(约 9.8 秒)
  • https://docker.xuanyuan.me(约 11.5 秒)
  • https://hub.rat.dev(约 14.9 秒)
  • https://dockerproxy.net(约 16.1 秒)

可以一键复制到 daemon.json 文件,或 Docker Desktop 的 Docker Engine 菜单下(建议全部写上,Docker 会按顺序尝试,失效自动 fallback):

daemon.json 配置
{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.m.daocloud.io",
    "https://docker.xuanyuan.me",
    "https://hub.rat.dev",
    "https://dockerproxy.net"
  ]
}
  

以下地址 2026 年 10 月 25 日实测已不可用,老教程里看到请直接跳过:

  • docker.unsee.tech、docker.mirrors.ustc.edu.cn、mirror.baidubce.com(TLS 连接被中断)
  • docker.nju.edu.cn、dockerhub.azk8s.cn(403,已不对公网开放)
  • docker.1panel.live(403,地区限制误伤,部分国内 IP 也被拦)
  • registry.docker-cn.com(连接超时,官方中国镜像早已关停)

    📮 公众号「扎克爱思」:这里写工具,那里写生活——一个程序员如何让 AI 接管自己的工作、健康和投资
    ☕ 如果这个配置帮你节省了时间,可以扫码支持一下
已复制到剪贴板

教程开始

在国内使用 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://docker.1ms.run",
    "https://docker.m.daocloud.io",
    "https://docker.xuanyuan.me",
    "https://hub.rat.dev",
    "https://dockerproxy.net"
  ]
}
  1. 点击 “Apply & Restart” 按钮应用更改

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

  1. 打开 Windows 资源管理器
  2. 导航到配置文件位置:%UserProfile%\.docker\daemon.json
  3. 如果文件不存在,创建新文件
  4. 添加或修改以下内容:
{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.m.daocloud.io",
    "https://docker.xuanyuan.me",
    "https://hub.rat.dev",
    "https://dockerproxy.net"
  ]
}
  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 的官方文档获取更多帮助。