全部產品
Search
文件中心

Container Registry:通過製品訂閱擷取海外源鏡像

更新時間:Sep 19, 2026

如果需要從Docker Hub、GCR、Quay等海外源鏡像倉庫擷取鏡像,可能會因網路問題遭遇拉取失敗。通過製品訂閱功能,ACR企業版執行個體支援將海外源或自訂來源鏡像直接同步處理到鏡像倉庫中,並無需額外配置網路。

適用範圍

僅ACR企業版執行個體基礎版、進階版支援該功能。不同執行個體的訂閱規則配額有所不同,詳情請參見製品訂閱。

設定自動訂閱

設定自動訂閱後,ACR企業版執行個體將會以特定規則自動將鏡像同步到目標鏡像倉庫中。

  1. 登入Container Registry控制台。

  2. 在頂部功能表列,選擇所需地區;然後在左側導覽列,選擇實例列表。

  3. 在實例列表頁面,單擊目標企業版執行個體,在左側導覽列中選擇倉庫管理 > 制品订阅。

  4. 在制品订阅頁面,單擊创建订阅规则,在對話方塊中設定下列參數,然後單擊下一步。

    參數

    說明

    制品来源

    選擇需要訂閱的源倉庫類型。選擇自定义源時,源倉庫須同時滿足以下條件:

    • 符合 Registry V2(Docker V2)協議。

    • 為公開類型倉庫(不支援私人倉庫)。

    • 可通過公網以 HTTPS 方式訪問。

    製品訂閱僅支援海外源和符合現有條件的自訂來源,不支援將 ACR 執行個體中的鏡像作為訂閱源。

    源端仓库域名

    該選項僅在為制品来源選擇自定义源時出現,且為必填項。

    自訂來源的網域名稱。例如,從龍蜥社區擷取鏡像時,可以填入anolis-registry.cn-zhangjiakou.cr.aliyuncs.com。

    源端仓库坐标

    源倉庫的座標,格式為<命名空間>/<倉庫>。例如,訂閱 Docker Hub 官方鏡像時填入library/nginx;訂閱龍蜥社區鏡像時填入openanolis/nginx。

    订阅策略

    訂閱源端倉庫鏡像版本(必填) :設定訂閱海外源鏡像版本需滿足的Regex。預設為 .*,表示計劃訂閱海外源倉庫下所有的鏡像版本。

    訂閱源端倉庫中的前N個鏡像(必填):從滿足上述Regex的海外源鏡像版本中,選擇前N個鏡像版本同步到企業版執行個體的目標倉庫。Docker Hub限額5個鏡像版本,其他源最多支援30個鏡像版本。

    作業系統或架構

    當海外源端倉庫中為多架構鏡像時,只將指定的作業系統或架構訂閱到企業版執行個體的目標倉庫。

  5. 在鏡像倉庫頁面中完成其他配置,然後單擊创建订阅规则。

    參數

    說明

    鏡像倉庫

    設定訂閱規則作用到的目標鏡像倉庫。

    镜像覆盖

    是否覆蓋企業版執行個體目標倉庫下已有同名鏡像。

    加速链路

    基於調度策略與網路鏈路最佳化,可提升鏡像訂閱速度。

    更新方式

    定期將訂閱源端倉庫的鏡像Tag同步到企業版執行個體的目標倉庫。

  6. ACR企業版執行個體後續會根據訂閱規則自動同步鏡像。如果需要在自動同步前使用鏡像,請參見執行立即同步。

執行立即同步

可以立即執行訂閱規則,完成鏡像同步。

  1. 登入Container Registry控制台。

  2. 在頂部功能表列,選擇所需地區;然後在左側導覽列,選擇實例列表。

  3. 在實例列表頁面,單擊目標企業版執行個體,在左側導覽列中選擇倉庫管理 > 制品订阅。

  4. 在制品订阅頁面,單擊目標訂閱策略操作列的立即执行。

  5. 在提示對話方塊,單擊確定。

    在訂閱任務完成後,可以在目標鏡像倉庫查看訂閱成功的鏡像。