配置未生效需验证三点：一是daemon.json语法合法、registry-mirrors格式正确且地址有效；二是执行systemctl daemon-reload和restart docker完成重载；三是排除DNS、防火墙及Docker Desktop独立配置干扰。
配置阿里云加速器后提示“无效”，通常不是地址写错了那么简单，而是配置未真正生效或被其他环节拦截。核心要验证三点：配置是否写对、是否重载生效、是否被网络或权限阻断。
检查 daemon.json 格式和内容是否合规
配置文件必须是合法 JSON，且 registry-mirrors 是数组格式，每个地址带完整协议头（https://）和正确路径。常见错误包括：
- 漏掉引号或逗号，导致 JSON 解析失败（可用
sudo jq . /etc/docker/daemon.json验证） - 用了已失效的旧加速地址（如阿里云早期
https://现已停用，需登录控制台重新获取）.mirror.aliyuncs.com - 混入中文标点、空格或注释（JSON 不支持注释，
//或/* */会导致加载失败） - 误把加速地址填在
insecure-registries或其他字段下
确认配置已重载并被 Docker 守护进程读取
改完配置不重启等于没改。必须执行两步：
-
sudo systemctl daemon-reload（重载 systemd 配置） -
sudo systemctl restart docker（重启守护进程）
重启后立即运行 docker info | grep -A 1 "Registry Mirrors"。如果输出为空或显示 none，说明配置未加载成功——大概率是 JSON 错误或文件权限不对（确保 /etc/docker/daemon.json 属主为 root，权限为 644）。
验证网络层是否真正走加速地址
即使配置正确，DNS 解析失败或防火墙拦截也会让请求 fallback 到官方源。可这样排查：
- 手动测试加速地址连通性：
curl -I https:///v2/（应返回 401 或 403，而非 timeout 或 connection refused） - 检查 DNS 是否正常：
nslookup registry-1.docker.io和nslookup，两者都应能解析 - 临时关闭防火墙测试：
sudo systemctl stop firewalld（CentOS）或sudo ufw disable（Ubuntu） - 若使用 Docker Desktop，注意其独立配置入口：Settings → Docker Engine → 修改 JSON 后点 Apply & Restart，不能只改系统级 daemon.json
排除缓存和镜像拉取行为干扰
Docker 会缓存历史拉取记录，有时仍尝试走旧路径。可强制刷新：
- 清理本地镜像缓存：
docker system prune -a（谨慎操作，会删未用镜像） - 明确指定加速器域名拉取：
docker pull /library/nginx:alpine（绕过配置逻辑直连测试） - 查看实际请求日志：
sudo journalctl -u docker -f | grep -i "registry\|mirror"，观察请求发往哪个域名
