Docker Desktop 配置国内镜像加速器教程

在中国大陆，由于访问 Docker Hub（默认镜像源）速度较慢，容易出现拉取镜像失败或非常缓慢的情况。为了提升镜像拉取速度，可以配置国内镜像加速器。

一、适用环境

操作系统：Windows / macOS
Docker 版本：Docker Desktop 4.x 或以上

二、配置步骤

1. 打开 Docker Desktop 设置

启动 Docker Desktop
点击右上角齿轮图标，进入 Settings（设置）
在左侧导航中点击 Docker Engine

2. 修改 `Docker Engine` 配置

找到 Docker Engine 设置页面中的 JSON 配置框，将内容修改为以下格式：

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.xuanyuan.me"
  ]
}
⚠️ 注意：registry-mirrors 字段是一个数组，可以写入多个加速器地址。请确保每一项都是合法的 HTTPS 地址。

3. 保存并重启 Docker 服务

点击右下角的 Apply & Restart（应用并重启）
等待 Docker 重启后配置生效

三、验证是否生效

执行以下命令测试镜像拉取速度：

docker pull busybox

若输出显示镜像从加速器地址拉取，且速度明显提升，则说明加速器配置成功。

四、常见问题

Q1: 配置后无法启动 Docker？

检查 JSON 格式是否正确（可使用 JSON 格式校验工具）
确保所有加速器地址可访问且合法

Q2: 镜像拉取仍然缓慢？

尝试更换其他可用加速器地址
检查网络代理或防火墙设置是否影响 Docker

五、附加说明

镜像加速器的作用仅限于公共镜像拉取。
私有仓库或内网仓库的拉取不受加速器影响。
使用多个镜像源时，Docker 会按顺序尝试。

如需进一步控制镜像缓存、构建行为等，也可通过 builder.gc 参数进行配置，如上文中的：

"builder": {
  "gc": {
    "defaultKeepStorage": "20GB",
    "enabled": true
  }
}
如需针对特定项目设置镜像源，也可在 Docker CLI 或 daemon.json 中单独配置，具体方式略有不同。

如果需要，我可以继续提供相关 CLI 设置或 Linux 下的配置方式。