国内Docker Desktop拉取镜像慢是因默认连接境外registry-1.docker.io，配置国内镜像源可大幅提升速度；推荐通过Settings→Docker Engine修改JSON添加registry-mirrors数组并Apply & Restart生效。
在国内使用 Docker Desktop 拉取镜像时，常遇到卡在 0%、超时失败或下载速度低于 100 KB/s 的情况——这几乎全是因默认连接境外 registry-1.docker.io 导致，而非本地网络或硬件问题。配置有效镜像源后，nginx 镜像拉取可从 5 分钟缩短至 12 秒内完成。
通过 Docker Desktop 图形界面配置（推荐新手）
第一步：右键点击任务栏（Windows）或菜单栏（macOS）中的 Docker 图标 → 选择 Settings（设置）。
第二步：在左侧导航栏中点击 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:\ProgramData\Docker\config\daemon.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:// 前缀以外的路径，例如 https://docker.1panel.live/v2/ 会导致认证失败。
验证镜像源是否生效
第一步：执行命令查看当前配置
docker info | findstr "Registry Mirrors"
第二步：观察输出结果
若返回行中包含你配置的任一域名（如 docker.1ms.run），说明 registry-mirrors 已加载成功；若返回空或显示 Registry Mirrors: <nil>，代表配置未生效或 JSON 解析失败。
第三步：实测拉取验证
运行 docker pull busybox，观察下载速度是否稳定在 2 MB/s 以上，且无 context deadline exceeded 报错。
