全部產品
Search

搜尋本產品

    Container Registry：配置專用網路的存取控制

    文件中心

    Container Registry：配置專用網路的存取控制

    更新時間：Aug 04, 2026

    ECS 等 VPC 內的資源需通過內網訪問 ACR 企業版執行個體時，需要先配置專用網路的存取控制，建立 VPC 與執行個體之間的網路連接。

    前提條件

    配置專用網路存取控制需要使用Alibaba Cloud DNS PrivateZone 完成 VPC 內網網域名稱解析。如果您不需要通過 VPC 內網訪問企業版執行個體，可以直接使用企業版執行個體的公網網域名稱進行鏡像推拉操作，無需配置專用網路存取控制，也無需開通Alibaba Cloud DNS PrivateZone。

    背景資訊

    建立專用網路與企業版執行個體的串連後，系統會佔用專用網路內的一個 IP，並通過Alibaba Cloud DNS PrivateZone 自動將執行個體內網網域名稱解析到該 IP，無需手動設定。

    網路存取控制是 VPC 層級的，建議選擇 IP 充足的交換器。綁定後整個 VPC 內的機器均可通過內網網域名稱訪問企業版執行個體。

    配置專用網路存取控制時，系統會自動建立服務關聯角色 AliyunServiceRoleForContainerRegistryAccessCustomerPrivateZone，用於調用Alibaba Cloud DNS PrivateZone 完成網域名稱解析。關於該角色的更多資訊，請參見雲解析PrivateZone的服務關聯角色。

    警告

    請勿更改在Alibaba Cloud DNS PrivateZone 自動建立的解析 Zone，否則會造成鏡像拉取失敗、刪除失敗等異常。

    添加專用網路

    VPC 存取控制配額需單獨購買，初始配額可能為 0。如配額不足或遇到配額超額提示，請參見常見問題。VPC 的配額及定價請參見企業版執行個體計費說明。

    1. 登入Container Registry控制台。

    2. 在頂部功能表列，選擇所需地區。

    3. 在左側導覽列，選擇實例列表。

    4. 在實例列表頁面單擊目標企業版執行個體。

    5. 在企業版執行個體管理頁面左側導覽列中選擇倉庫管理 > 訪問控制。

      如果您需要為Helm Chart配置存取控制，請選擇Helm Chart > 訪問控制。

    6. 在专有网络頁簽下，單擊添加專有網絡。

    7. 在添加專有網絡對話方塊中，分別選擇已有專用網路和已有交換器，並單擊確定。

      只需要綁定一台交換器與專用網路，該專用網路下的ECS都可以訪問企業版執行個體。

      待該專用網路的狀態由创建中變為已生效後，說明專用網路添加成功。

    8. 可選：查看雲解析PrivateZone的解析Zone。

      添加專用網路成功後，ACR 會自動在Alibaba Cloud DNS PrivateZone 中建立解析 Zone。您可以在Alibaba Cloud DNS PrivateZone 查看解析 Zone。

      1. 登入Alibaba Cloud DNS控制台。

      2. 在控制台左側導覽列單擊解析配置 > 内网域名解析。

        在用户域名頁簽下查看解析Zone。

    常見問題

    為什麼在同一 VPC 下無法 Ping 通 ACR 企業版執行個體或 DNS 解析失敗？

    原因是未在 ACR 控制台將企業版執行個體綁定到該 VPC，導致Alibaba Cloud DNS PrivateZone 未為該 VPC 建立對應的解析 Zone。

    解決方案：按照本文添加專用網路，將目標 VPC 和交換器綁定到 ACR 企業版執行個體，待該專用網路的狀態變為已生效後，即可在 VPC 內正常解析並訪問企業版執行個體。

    使用 VPC 地址推拉鏡像時，報錯"Image address must be a VPC endpoint"或"Get EOF"怎麼辦？

    請根據具體報錯分別處理：

    1. 報錯"Image address must be a VPC endpoint"：通常是因為在非 VPC 環境中使用了 VPC 網域名稱，或在 VPC 環境中誤用了公網網域名稱。請檢查當前網路環境：

      • VPC 內應使用 *-registry-vpc.{region-id}.cr.aliyuncs.com 格式的網域名稱。

      • 公網環境應使用 *-registry.{region-id}.cr.aliyuncs.com 格式的網域名稱。

    2. 推送鏡像報錯"Get EOF"：通常是因為用戶端不在已綁定 ACR 的 VPC 網路內，或網路不通。請確認用戶端處於已綁定 ACR 企業版執行個體的正確 VPC 環境中，或改用公網網域名稱進行推送。

    VPC 配額為 0 或添加專用網路時提示配額超額怎麼辦？

    VPC 存取控制配額需單獨購買，初始配額可能為 0。如果暫時不需要通過 VPC 內網拉取鏡像，則無需配置 VPC 存取控制，也不會產生額外費用。如果後續有在 VPC 內（如 ECS、ACK 叢集中）拉取鏡像的需求，需先購買配額再執行 VPC 綁定操作。不同規格的配額及定價請參見企業版執行個體計費說明。

    如果添加專用網路時提示配額超額，請按以下步驟擴容：

    1. 登入VPC 控制台，查看當前配額使用。

    2. 在配額管理頁面單擊升級購買，擴容 VPC 配額。

    3. 購買完成後，清理瀏覽器緩衝並等待配額生效。

    4. 重新在 ACR 企業版執行個體的訪問控制頁面單擊添加專有網絡。

    相關文檔

    如果您需要在專用網路環境下，實現跨地區訪問企業版執行個體，請參見跨地區或從IDC訪問企業版執行個體。

    如果配置專用網路存取控制過程中遇到問題（如 VPC 與執行個體未成功打通、網域名稱解析異常、PrivateZone 錯誤碼等），請參見專用網路存取控制故障排查。