Windows Docker 设置阿里云镜像加速：适用限制、配置与排查
2026-09-10 资料核对：中科大官方帮助页已说明镜像缓存服务关闭；阿里云公告对加速器的使用环境与可拉取范围作出限制。本文不再将旧公共地址列表当作当前可用清单。以下配置须使用你已确认可用且信任的服务，本次未在你的目标网络完成镜像拉取实测。
原文记录了 Windows 上使用阿里云镜像加速的过程。现在先确认服务对你的使用场景是否开放，再配置 Docker Desktop。特别是普通本地电脑，不应仅凭拿到了加速地址，就推断符合阿里云当前的使用条件。
先分清镜像源解决哪一层问题
Docker Hub 镜像加速、Docker 软件安装源、容器内的软件包源，是三种不同配置。registry-mirrors 用于 Docker Engine 拉取 Docker Hub 镜像时的镜像服务，不会自动解决其他仓库、GitHub 下载或构建步骤中的网络问题。
一份能解析的 JSON 不代表镜像服务可用；docker info 显示地址也只说明守护进程读取了配置。镜像内容是否齐全、标签是否更新、你的网络和账户是否获准使用，仍需分别确认。
1. 确认可使用的服务
阅读 阿里云 ACR 镜像加速器调整公告，在账户控制台核对实际资格和地址。若不适用，可使用组织提供的授权仓库或已配置好的网络方案；本文不提供未经验证的公共加速列表。
2. 在 Docker Desktop 中合并配置
本文面向使用 Linux 容器的 Docker Desktop。打开 Settings → Docker Engine，先复制保存当前 JSON，再合并 registry-mirrors 字段。不同版本界面文字可能略有差异。
{
"registry-mirrors": [
"https://your-authorized-mirror.example.com"
]
}上面的 example.com 地址是格式占位符，不能直接使用。请替换为你获准使用的真实 HTTPS 地址；将字段合并进原有 JSON，保留其他配置并避免重复键。
确认没有重要任务正在运行后，使用界面提供的 Apply & restart 应用配置。重启 Docker Desktop 可能影响正在运行的容器。
验证、排错与回退
docker info --format "{{json .RegistryConfig.Mirrors}}"
docker pull hello-world:latest
docker image inspect hello-world:latest --format "{{json .RepoDigests}}"第二步只拉取镜像，不会运行容器。记录时间、Docker 版本和错误信息。镜像可能已经存在于本地，成功也可能来自上游回退，因此单凭一次成功不能证明某个镜像站的速度或命中情况。
- 配置后无法启动：先检查 JSON 语法，恢复修改前的配置。
- 超时或名称解析失败：分别排查服务地址、DNS、守护进程代理与网络。
- unauthorized / denied：确认服务授权、登录方式和镜像范围。
- manifest unknown：核对仓库名、标签和平台支持；不要仅靠反复换源解决。
如需撤销，只撤回本次添加或修改的镜像配置，再重新应用。不要清空所有镜像、容器或卷作为常规排错方式。