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：获取阿里云公共镜像加速地址
阿里云登录 – 欢迎登录阿里云，安全稳定的云计算服务平台
步骤 2：配置 Docker Desktop
json
{
"registry-mirrors": ["https://xxxxxx.mirror.aliyuncs.com"] // 替换为你的公共加速地址
}
- 若已有其他配置，确保键值对间用逗号分隔（如 "experimental": false,）。
- 禁止添加注释（JSON 不支持 // 注释，会导致语法错误）。
正确配置后如下：
{
"builder": {
"gc": {
"defaultKeepStorage": "20GB",
"enabled": true
}
},
"experimental": false,
"registry-mirrors": [
"这里删除汉字并粘贴替换为获取到的镜像加速地址"
]
}
步骤 3：保存配置并重启 Docker
- 立即恢复默认配置（点击 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 实例？
若需以下功能，才需在 实例列表 中创建个人版 / 企业版实例（个人版免费）：
常见问题排查
| 403 Forbidden 拉取失败 | ① 网络代理限制（如公司内网屏蔽阿里云域名）→ 检查代理设置；② 加速地址拼写错误 → 重新复制粘贴。 |
| Docker 重启后配置失效 | JSON 语法错误（如逗号遗漏、引号未闭合）→ 用在线工具验证语法。 |
| 拉取速度未提升 | ① 网络未走加速器（检查 docker info）；② 地域节点远 → 尝试切换加速地址（阿里云会根据 IP 自动分配近地节点）。 |
总结
阿里云的 公共镜像加速器 是 “零门槛” 福利，无需创建实例即可加速公共镜像拉取。若仅需基础加速，按上述步骤配置即可；若需私有镜像托管等高级功能，再按需创建实例，两者互不冲突。配置完成后，Docker 拉取公共镜像的效率将显著提升！ 🚀
