1. 打开 Docker Engine 设置#

启动 Docker Desktop，然后依次进入：

Settings → Docker Engine

右侧会显示 Docker Engine 当前使用的 JSON 配置。默认内容可能不止一项，以你电脑上的实际内容为准。

2. 添加镜像地址#

如果当前配置接近下面这样：

1
{
2
  "features": {
3
    "containerd-snapshotter": true
4
  }
5
}

可以在顶层加入 registry-mirrors：

1
{
2
  "features": {
3
    "containerd-snapshotter": true
4
  },
5
  "registry-mirrors": [
6
    "https://docker.1ms.run"
7
  ]
8
}

注意 JSON 格式：相邻字段之间要有英文逗号，最后一个字段后面不要多写逗号。

3. 保存并重启#

点击 Apply & restart。Docker Desktop 会校验配置并重启 Docker Engine。

重启完成后，在 PowerShell、Windows Terminal 或 macOS 终端中执行：

1
docker info

在输出中找到 Registry Mirrors。如果能看到以下地址，说明配置已经被 Docker 读取：

1
Registry Mirrors:
2
 https://docker.1ms.run/

然后实际拉取一个小镜像测试：

1
docker pull hello-world
2
docker run --rm hello-world

Docker Desktop 配置失败怎么恢复#

如果点击保存后 Docker 无法启动，重新进入 Settings → Docker Engine，删除刚才加入的 registry-mirrors 字段，恢复原来的 JSON 后再次应用。

最常见的原因是 JSON 少了逗号、多了逗号，或者误删了原有的大括号。修改前可以先把原配置复制到记事本中备份。

1. 备份已有配置#

先查看文件是否存在：

1
sudo ls -l /etc/docker/daemon.json

如果存在，先备份：

1
sudo cp /etc/docker/daemon.json /etc/docker/daemon.json.bak

2. 编辑 daemon.json#

创建配置目录并使用编辑器打开文件：

1
sudo mkdir -p /etc/docker
2
sudo nano /etc/docker/daemon.json

新文件可以直接填写：

1
{
2
  "registry-mirrors": [
3
    "https://docker.1ms.run"
4
  ]
5
}

如果原文件中已经设置了日志、存储目录或其他参数，应保留这些字段。例如：

1
{
2
  "log-driver": "json-file",
3
  "log-opts": {
4
    "max-size": "20m",
5
    "max-file": "3"
6
  },
7
  "registry-mirrors": [
8
    "https://docker.1ms.run"
9
  ]
10
}

在 nano 中按 Ctrl+O 保存，按回车确认文件名，再按 Ctrl+X 退出。

3. 重启 Docker#

对于使用 systemd 的 Ubuntu、Debian、CentOS、Rocky Linux 等常见发行版，执行：

1
sudo systemctl daemon-reload
2
sudo systemctl restart docker
3
sudo systemctl status docker --no-pager

如果状态显示 active (running)，说明 Docker 已正常启动。

4. 验证配置#

执行：

1
docker info | sed -n '/Registry Mirrors/,+3p'

正常情况下会显示：

1
 Registry Mirrors:
2
  https://docker.1ms.run/

再拉取镜像测试：

1
docker pull hello-world
2
docker run --rm hello-world

docker info 中没有 Registry Mirrors#

先确认修改的是当前 Docker 实例所使用的配置：

• Docker Desktop 应在 Settings → Docker Engine 中修改；
• 普通 Linux Docker Engine 通常使用 /etc/docker/daemon.json；
• rootless Docker 通常使用 ~/.config/docker/daemon.json；
• 修改后需要重启对应的 Docker Engine。

Docker 重启失败#

查看日志：

1
sudo journalctl -u docker -n 100 --no-pager

如果提示无法解析配置，通常是 JSON 格式错误。可以恢复备份：

1
sudo cp /etc/docker/daemon.json.bak /etc/docker/daemon.json
2
sudo systemctl restart docker

配置成功但拉取仍然很慢#

可能原因包括：

• 镜像站暂时不可用、拥堵或触发额度限制；
• DNS 解析异常；
• 要拉取的镜像并不在 Docker Hub；
• 镜像包含较大的层，首次回源仍需等待；
• 公司、校园或云服务器网络策略限制了相关域名。

可以先测试镜像站是否能够访问，再查看 Docker 日志中的实际错误。不要随意加入 insecure-registries，本文示例使用 HTTPS，不需要关闭 TLS 校验。

docker pull 和 docker compose 是否都生效#

只要 Compose 使用的是同一个 Docker Engine，针对 Docker Hub 的 registry-mirrors 配置通常会同时作用于 docker pull 和 docker compose pull。如果 Compose 文件已经写了其他仓库的完整域名，则仍会访问那个仓库。