国内用 Docker Desktop 拉镜像，经常卡在 0%、超时失败、速度不到 100 KB/s。问题根源其实很简单——默认连的是境外的 registry-1.docker.io，跟本地网速或机器配置没关系。换一个能用的镜像源，拉取 nginx 镜像的时间，能直接从 5 分钟压缩到 12 秒以内。

通过 Docker Desktop 图形界面配置（推荐新手）

第一步：打开设置
右键点击任务栏（Windows）或菜单栏（macOS）里的 Docker 图标，选 Settings（设置）。

第二步：找到 Docker Engine 选项卡
左侧导航栏找到 Docker Engine，右边会弹出一个 JSON 格式的配置编辑框。

第三步：粘贴镜像源配置
把下面这段内容直接粘贴进去——注意，必须完全覆盖原有内容，不能只改部分字段：

{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.xuanyuan.me",
    "https://hub-mirror.c.163.com"
  ]
}

第四步：检查 JSON 格式
重点是左右大括号配对、每个 URL 都用英文双引号包好、数组末尾没有多余逗号。格式一旦写错，Docker 启动会直接失败，而且不会自动恢复。

第五步：重启生效
点击右下角的 Apply & Restart，等 Docker Engine 重启（通常 15–25 秒）。右下角状态灯变绿就算生效了。

手动修改 daemon.json 文件（适合批量部署或脚本化）

方法一：定位并编辑配置文件

Windows 路径：C:ProgramDataDockerconfigdaemon.json；macOS 路径：~/Library/Containers/com.docker.docker/Data/docker-daemon.json。

用 VS Code 或者记事本（记得以管理员身份运行）打开。如果文件不存在或者为空，新建一个纯文本文件，写入最小有效结构：

{
  "registry-mirrors": ["https://mirror.baidubce.com"]
}

方法二：保留已有配置时的修改要点

原文件里如果有 "experimental": true 或 "builder" 之类的字段，registry-mirrors 必须作为顶层键出现，而且值必须是字符串数组，不能嵌套在其他对象里。添加完以后，务必确认逗号位置没错——放错一个逗号，文件就废了。

方法三：使配置生效的关键动作

保存文件之后，Docker Desktop 不会自动读新配置——你还得去 Settings → Docker Engine → 点一下 Apply & Restart，才算真正激活。跳过这一步，等于白配。

临时指定镜像源（单次命令验证用）

打开终端（PowerShell 或 Terminal），执行带 --registry-mirror 参数的拉取命令：

docker pull hello-world --registry-mirror https://docker.1panel.live

这个方式不修改任何配置，只对这一次操作生效。适合快速确认某个镜像源能不能用，或者在受限环境下临时绕过全局策略。

注意：URL 后面不要加多余路径，比如 https://docker.1panel.live/v2/——加上反而会导致认证失败。

验证镜像源是否生效

第一步：查看当前配置

docker info | findstr "Registry Mirrors"

第二步：看输出结果

如果返回的行里出现你配置的域名（比如 docker.1ms.run），说明 registry-mirrors 已经加载成功。要是返回空或者显示 Registry Mirrors: ，那就是配置没生效，或者 JSON 解析出错了。

第三步：实测拉取

跑一句 docker pull busybox，看看下载速度能不能稳定在 2 MB/s 以上，同时没有 context deadline exceeded 的报错。能跑通，基本就稳了。

《夸克》非常好用的免费AI浏览器

下载APP查看