国内拉取docker镜像需配置registry-mirrors加速，linux须在/etc/docker/daemon.json中严格按json格式写入镜像地址并重启服务，windows/macos通过docker desktop图形界面配置，配置错误会导致服务启动失败，验证需检查docker info输出及pull日志。
国内拉取Docker镜像常因网络延迟卡在“Downloading”或直接超时，Nginx镜像未加速时实测耗时4分28秒，配置正确加速地址后压降至42秒——这一步必须在daemon.json里写对，错一个斜杠或少一对引号都会导致Docker服务启动失败。
Linux系统：手动编辑daemon.json
第一步：确认Docker已安装且运行中，执行systemctl is-active docker，返回active方可继续。
第二步：创建或覆盖配置文件，运行以下命令（会自动创建目录并写入JSON）：
sudo mkdir -p /etc/docker && sudo tee /etc/docker/daemon.json { "registry-mirrors": ["https://hub-mirror.c.163.com", "https://mirror.baidubce.com"] }<br>EOF
注意：必须用双引号包裹URL，数组格式严格为["url1", "url2"]，不能多逗号、不能缺中括号，否则dockerd将拒绝启动。
第三步：重载配置并重启服务：sudo systemctl daemon-reload && sudo systemctl restart docker。
第四步：验证是否生效，运行docker info | grep -A 1 "Registry Mirrors"，输出应显示你刚填的两个地址。
Windows/macOS：通过Docker Desktop图形界面配置
打开Docker Desktop → 点击右上角齿轮图标 → 左侧选「Docker Engine」→ 在右侧JSON编辑框中修改registry-mirrors字段。
方法一：单源配置（推荐新手）
把整个内容替换成：{"registry-mirrors": ["https://<your-id>.mirror.aliyuncs.com"]}</your-id>
其中<your-id></your-id>需替换为你在阿里云容器镜像服务控制台获取的专属ID，【不填ID会导致404错误，镜像拉取仍走海外直连】。
方法二：多源兜底配置（防单点失效）
填入：{"registry-mirrors": ["https://mirrors.tencent.com", "https://docker.mirrors.tuna.tsinghua.edu.cn"]}
清华源和腾讯源均无需注册，开箱即用，适合临时调试或测试环境。
改完点击「Apply & Restart」，Docker Desktop会自动重启引擎。
验证加速是否真正生效
运行time docker pull nginx:alpine，观察实际下载耗时；同时打开终端另一窗口，执行sudo journalctl -u docker.service -f实时查看日志。
如果看到类似Using default tag: latest → Pulling from library/nginx → Using registry-1.docker.io → ...说明没走加速——这是典型配置未生效或URL写错的信号。
真正生效的日志会显示Using https://hub-mirror.c.163.com/v2/或对应你填的域名前缀，且首字节响应时间通常＜300ms。
执行docker info后，Registry Mirrors字段必须非空且与你配置完全一致，大小写、斜杠方向、引号类型都不能有偏差。
