【笔记】Docker 配置阿里云镜像加速（公共地址即开即用，无需手动创建实例）
2025年06月25日记
【好用但慎用】Windows 系统中将所有 WSL 发行版从 C 盘迁移到 非系统 盘的完整笔记（附 异常处理）-CSDN博客
【笔记】解决 WSL 迁移后 Docker 出现 “starting services: initializing Docker API Proxy: setting up docker ap” 问题-CSDN博客
Docker 配置阿里云镜像加速（公共地址即开即用，无需手动创建实例）
核心说明
阿里云为所有用户提供 公共镜像加速器服务，无需手动创建 ACR 实例即可直接使用（加速拉取 Docker Hub、Google 等公共镜像）。若需托管私有镜像、开启企业级功能（如镜像构建、安全扫描），再按需创建个人版 / 企业版实例。
步骤 1：获取阿里云公共镜像加速地址
阿里云登录 - 欢迎登录阿里云，安全稳定的云计算服务平台
- 访问 阿里云容器镜像服务控制台，登录阿里云个人认证账号（若无账号需注册）。
- 左侧导航栏点击 镜像加速器（无需进入 “实例列表” 创建实例）。
- 页面中直接复制 公共加速地址（形如
https://xxxxxx.mirror.aliyuncs.com）。
步骤 2：配置 Docker Desktop
- 打开 Docker Desktop，右键托盘图标 → Settings（或 Preferences）。
- 左侧菜单选择 Docker Engine（部分版本显示为 Engine）。
- 在 JSON 配置中添加
registry-mirrors字段（严格遵循 JSON 语法）：json
{"registry-mirrors": ["https://xxxxxx.mirror.aliyuncs.com"] // 替换为你的公共加速地址 }- 若已有其他配置，确保键值对间用逗号分隔（如
"experimental": false,）。 - 禁止添加注释（JSON 不支持
//注释，会导致语法错误）。
- 若已有其他配置，确保键值对间用逗号分隔（如
正确配置后如下：
{"builder": {"gc": {"defaultKeepStorage": "20GB","enabled": true}},"experimental": false,"registry-mirrors": ["这里删除汉字并粘贴替换为获取到的镜像加速地址"]
}
步骤 3：保存配置并重启 Docker
- 点击 Apply & Restart，等待 Docker 重启（托盘图标变绿，底部显示
Engine running）。 - 若重启失败：
- 立即恢复默认配置（点击 Reset to Defaults），检查 JSON 语法（可用 在线 JSON 校验工具 验证）。
步骤 4：验证加速是否生效
方法 1：通过 docker info 检查
打开终端（PowerShell/Command Prompt），运行：
docker info
在输出中找到 Registry Mirrors，若显示你的加速地址（如 https://xxxxxx.mirror.aliyuncs.com/），则配置成功 ✅。
方法 2：拉取公共镜像测试速度
docker pull nginx # 拉取官方镜像，观察拉取速度
- 若加速生效：拉取耗时应明显短于未配置时（可对比历史拉取时间）。
- 也可直接拉取其他镜像测试。
补充：何时需要创建 ACR 实例？
若需以下功能，才需在 实例列表 中创建个人版 / 企业版实例（个人版免费）：
- 托管私有镜像：将自己构建的镜像（如
my-app:v1.0）推送到阿里云仓库。 - 镜像构建自动化：绑定 GitHub/GitLab 代码仓库，实现 “代码变更 → 自动构建镜像”。
- 企业级能力：多团队权限管理、镜像安全扫描、流量配额控制等。
常见问题排查
| 问题现象 | 原因 & 解决方案 |
|---|---|
403 Forbidden 拉取失败 | ① 网络代理限制（如公司内网屏蔽阿里云域名）→ 检查代理设置；② 加速地址拼写错误 → 重新复制粘贴。 |
| Docker 重启后配置失效 | JSON 语法错误（如逗号遗漏、引号未闭合）→ 用在线工具验证语法。 |
| 拉取速度未提升 | ① 网络未走加速器（检查 docker info）；② 地域节点远 → 尝试切换加速地址（阿里云会根据 IP 自动分配近地节点）。 |
总结
阿里云的 公共镜像加速器 是 “零门槛” 福利，无需创建实例即可加速公共镜像拉取。若仅需基础加速，按上述步骤配置即可；若需私有镜像托管等高级功能，再按需创建实例，两者互不冲突。配置完成后，Docker 拉取公共镜像的效率将显著提升！ 🚀