Docker 更换国内源教程

Docker 默认使用国外官方源，下载镜像时速度较慢，甚至出现超时失败。本教程适配 Windows、macOS、Linux 三大系统，教你更换国内优质镜像源，解决下载慢问题，同时附上源的优先级、测试方法及常见问题排查。

一、前置准备

已安装 Docker Desktop（Windows/macOS）或 Docker Engine（Linux），且能正常启动。
确认网络通畅，能访问国内镜像源服务器（如阿里云、网易、科大等）。
Linux 系统需具备 root 权限（或 sudo 权限），Windows/macOS 需以管理员身份操作 Docker。

二、常用国内优质 Docker 源

优先选择稳定、更新及时的源，以下是主流国内源（任选其一或组合使用）：

阿里云 Docker 镜像源（推荐）：https://docker.mirrors.aliyun.com
网易云 Docker 镜像源：https://hub-mirror.c.163.com
科大镜像源：https://docker.mirrors.ustc.edu.cn
腾讯云 Docker 镜像源：https://mirror.ccs.tencentyun.com
华为云 Docker 镜像源：https://mirrors.huaweicloud.com/docker/

注意：部分源可能存在临时维护，若更换后无法使用，可切换至其他源。

提示

提示本网站已搭建自动生成配置文件的程序自动获取最新国内可用源可前往 docker配置文件进行配置。

三、分系统更换教程

3.1 Windows 系统（Docker Desktop）

打开 Docker Desktop，点击右上角「设置」（齿轮图标）。
在左侧菜单中找到「Docker Engine」，点击进入配置页面。
在配置文件中，找到 registry-mirrors 字段，添加国内源地址（格式如下），多个源用逗号分隔：

json
 {
  "registry-mirrors": [
    "https://docker.mirrors.aliyun.com",
    "https://hub-mirror.c.163.com"
  ],
  "insecure-registries": [],
  "debug": false,
  "experimental": false,
  "features": {
    "buildkit": true
  }
}

点击右下角「Apply & Restart」，等待 Docker 重启完成，源更换生效。

3.2 macOS 系统（Docker Desktop）

打开 Docker Desktop，点击顶部菜单栏「Docker」→「设置」。
选择左侧「Docker Engine」，进入配置界面（与 Windows 操作一致）。
在 registry-mirrors 中添加国内源，保存配置并重启 Docker 即可。

3.3 Linux 系统（Ubuntu/Debian/CentOS 通用）

Linux 系统通过修改 Docker 配置文件 /etc/docker/daemon.json 实现换源，步骤如下：

打开终端，执行命令创建/编辑配置文件（若文件不存在则自动创建）： sudo vim /etc/docker/daemon.json
按 i 进入编辑模式，添加以下内容（替换为你选择的国内源）：

json
 {
  "registry-mirrors": [
    "https://docker.mirrors.aliyun.com",
    "https://hub-mirror.c.163.com"
  ],
  "insecure-registries": [],
  "debug": false,
  "experimental": false,
  "features": {
    "buildkit": true
  }
}

按 Esc，输入 :wq 保存并退出编辑。
重启 Docker 服务，使配置生效：# 重启 Docker 服务 sudo systemctl restart docker

查看 Docker 状态，确认重启成功

sudo systemctl status docker

四、验证源是否更换成功

无论哪种系统，更换源后可通过以下命令验证，确认镜像源已生效： docker info 执行命令后，找到「Registry Mirrors」字段，若显示你配置的国内源地址，说明更换成功。

五、注意事项

若配置多个源，Docker 会按顺序优先使用第一个源，若第一个源不可用，自动切换至下一个。
配置时注意 JSON 格式正确，逗号、引号不能遗漏，否则 Docker 无法正常启动（可通过 sudo systemctl status docker 查看错误日志）。
部分私有镜像仓库（如公司内部仓库），需在 insecure-registries 中添加仓库地址，否则无法拉取镜像。
若更换源后仍下载缓慢，可尝试清除 Docker 缓存：docker system prune -a（谨慎执行，会删除未使用的镜像、容器等）。

六、常见问题排查

6.1 Docker 重启失败

原因：配置文件 daemon.json 格式错误（如逗号缺失、引号不匹配）。解决：重新编辑配置文件，检查 JSON 格式，确保无误后再次重启。

6.2 验证时未显示配置的源

原因：未重启 Docker 服务，或配置文件路径错误（Linux 需确保路径为 /etc/docker/daemon.json）。解决：重启 Docker 服务，重新执行 docker info 验证。

6.3 下载镜像仍超时

原因：所选源临时维护，或网络存在限制。解决：切换至其他国内源，或检查网络连接，关闭防火墙/代理后重试。

七、总结

更换 Docker 国内源是解决镜像下载慢的关键操作，不同系统操作流程基本一致，核心是修改 Docker 引擎的镜像源配置，重启后即可生效。建议优先选择阿里云、科大等稳定源，确保镜像下载流畅。