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：獲取阿里云公共鏡像加速地址

阿里云登錄 - 歡迎登錄阿里云，安全穩定的云計算服務平臺?

1. 訪問?阿里云容器鏡像服務控制臺，登錄阿里云個人認證賬號（若無賬號需注冊）。
2. 左側導航欄點擊?鏡像加速器（無需進入 “實例列表” 創建實例）。
3. 頁面中直接復制?公共加速地址（形如?https://xxxxxx.mirror.aliyuncs.com）。

?

步驟 2：配置 Docker Desktop

1. 打開 Docker Desktop，右鍵托盤圖標 →?Settings（或?Preferences）。
2. 左側菜單選擇?Docker Engine（部分版本顯示為?Engine）。
3. 在 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

1. 點擊?Apply & Restart，等待 Docker 重啟（托盤圖標變綠，底部顯示?Engine running）。
2. 若重啟失敗：
   • 立即恢復默認配置（點擊?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 實例？

若需以下功能，才需在?實例列表?中創建個人版 / 企業版實例（個人版免費）：

1. 托管私有鏡像：將自己構建的鏡像（如?my-app:v1.0）推送到阿里云倉庫。
2. 鏡像構建自動化：綁定 GitHub/GitLab 代碼倉庫，實現 “代碼變更 → 自動構建鏡像”。
3. 企業級能力：多團隊權限管理、鏡像安全掃描、流量配額控制等。

常見問題排查

問題現象	原因 & 解決方案
403 Forbidden?拉取失敗	① 網絡代理限制（如公司內網屏蔽阿里云域名）→ 檢查代理設置；② 加速地址拼寫錯誤 → 重新復制粘貼。
Docker 重啟后配置失效	JSON 語法錯誤（如逗號遺漏、引號未閉合）→ 用在線工具驗證語法。
拉取速度未提升	① 網絡未走加速器（檢查?docker info）；② 地域節點遠 → 嘗試切換加速地址（阿里云會根據 IP 自動分配近地節點）。

總結

阿里云的?公共鏡像加速器?是 “零門檻” 福利，無需創建實例即可加速公共鏡像拉取。若僅需基礎加速，按上述步驟配置即可；若需私有鏡像托管等高級功能，再按需創建實例，兩者互不沖突。配置完成后，Docker 拉取公共鏡像的效率將顯著提升！ 🚀