docker拉镜像慢是因为默认源registry-1.docker.io位于美国，国内直连易超时或卡住；需配置镜像加速器：修改/etc/docker/daemon.json、重启docker服务、验证生效。

为什么 Docker 拉镜像慢？不是网络问题，是默认源在海外

Docker 默认从 registry-1.docker.io 拉取镜像，服务器位于美国，国内直连常出现超时、卡在 Waiting、pull access denied（实为连接失败被误判）等现象。这不是你配置错了，而是默认没设加速器——Docker 官方不主动告诉你这事，但国内几乎所有生产环境都必须配。

配置 Docker 镜像加速器的三步实操（CentOS/RHEL/Ubuntu 通用）

核心操作就三步，且顺序不能乱：改配置 → 重启服务 → 验证生效。任何跳过重启或忽略 daemon.json 格式细节的操作，都会导致加速器“看似配了，实际没用”。

• 编辑或创建配置文件：/etc/docker/daemon.json（若不存在则新建）
• 写入标准 JSON 格式内容（注意逗号、引号、括号）：

  { "registry-mirrors": ["https://<code>xxxx</code>.mirror.aliyuncs.com"] }

  其中 xxxx 替换为你的阿里云加速器 ID（免费注册 阿里云容器镜像服务 即可获取；清华源为 https://docker.mirrors.ustc.edu.cn，华为云为 https://<code>xxxx.mirror.huaweicloud.com）
• 重启 Docker 服务：sudo systemctl restart docker（systemctl status docker 确认 active (running)）

常见失效场景和对应排查点

加速器配完却没提速？大概率掉进了这几个坑里：

• daemon.json 文件权限不对（应为 root:root 且权限 ≤644），Docker 启动时静默忽略错误
• JSON 格式非法（多一个逗号、少一个引号、用了中文标点），sudo dockerd --validate 可直接报错定位
• 配置了多个镜像地址但没加逗号分隔，或混用了 http:// 和 https://（必须全用 https://）
• 使用了旧版 Docker（registry-mirrors 数组写法，需降级为单个字符串

Ubuntu 22.04 / CentOS Stream 9 等新系统额外注意

这些系统默认启用 cgroup v2，若加速器配置后 docker info 显示 Registry Mirrors: <none></none>，说明 daemon.json 被完全忽略——极可能是 /etc/docker/ 目录被 systemd 的 ProtectHome=true 策略拦截。此时需确认：sudo systemctl cat docker 中是否含 ProtectHome=，若有，临时方案是改用 sudo dockerd --registry-mirror=https://<code>xxxx.mirror.aliyuncs.com & 手动启动验证，再调整 service 文件。

真正容易被忽略的，是加速器只影响 docker pull 和 docker build 中的 FROM，不影响 docker run 已缓存的本地镜像；也不解决私有仓库认证问题——那得另配 ~/.docker/config.json。