文档中心

镜像仓库

镜像迁移/同步

镜像仓库实例异地容灾

本文介绍如何基于镜像仓库 CR 的同步规则与多地域标准版实例，通过公网链路与 DNS CNAME 解析构建容器镜像异地容灾方案。业务侧镜像地址固定使用自定义域名，主地域故障时仅需切换 DNS 解析即可完成入口切换，业务端无需修改任何镜像路径或配置。

场景介绍

本文以华东 2（上海）镜像仓库主实例出现故障，切换到华南 1（广州）镜像仓库备实例为例，为您介绍进行仓库异地容灾的操作方法。正常情况下业务访问的自定义域名 test.cr-test.team 指向上海主实例公网域名，容灾切换后该地址指向广州备实例公网域名。

本文涉及的资源和示例名称如下。

资源名称	示例值	说明
实例名称	testmonitor	主地域和备地域实例的名称相同。
上海主实例域名	testmonitor-cn-shanghai.cr.volces.com	主地域实例公网访问域名。
广州备实例域名	testmonitor-cn-guangzhou.cr.volces.com	备地域实例公网访问域名。
自定义域名	test.cr-test.team	业务访问入口，主备实例均需绑定。
命名空间	test	主备实例中均需创建同名命名空间。
镜像路径	test.cr-test.team/test/busybox:latest	业务侧固定使用的镜像地址。

前提条件

镜像仓库

已在华东 2（上海）和华南 1（广州）分别创建镜像仓库标准版实例，操作详情参见创建标准实例。

域名

已注册域名，操作详情参见域名注册。

如果需要在中国地区通过公网访问实例，请确保配置的自定义域名已通过备案审核，并在访问来源开启公网；如果尚未备案，请参考域名备案流程，或前往提供域名的云服务商完成域名备案。

说明

域名备案存在 30 分钟的延迟。即备案完成后的 30 分钟后才能用于创建自定义域名。

已上传域名的 SSL 证书，操作方法参见证书中心快速入门。

操作步骤

步骤一：开启公网访问

分别为主实例（上海）和备实例（广州）开启公网访问，并配置访问控制白名单。以下以主实例为例，备实例操作相同。

登录目标实例。

登录镜像仓库控制台。

在顶部导航栏，选择华东2（上海）。

在左侧导航栏，单击实例列表标准实例，找到目标实例 testmonitor 并单击进入实例。

在左侧导航栏选择访问控制，单击公网 > 开启/关闭开关。

在二次确认页面，单击确定。

在开启公网访问对话框中，配置白名单地址。

说明

本示例中访问控制白名单填写 0.0.0.0/0（允许所有 IP），仅用于测试验证。实际业务中请根据信息安全要求，仅配置涉及业务的 IP 地址段。

单击确定。

步骤二：创建自定义域名

为主备实例创建相同的自定义域名后，容灾前后镜像仓库实例的域名不变，无需修改业务代码。以下以主实例为例，备实例操作相同。

在左侧导航栏选择域名管理，单击添加自定义域名。

配置自定义域名参数。

参数	说明
类型	选择自定义，使用已备案的第三方域名创建自定义域名。
域名	填写已备案的自定义域名，本示例为 test.cr-test.team。
证书	选择已上传的证书。
访问来源	开启 VPC 访问，后续将在 PrivateZone 中为上海实例所在的 VPC 配置解析记录，将自定义域名解析至广州备实例的公网域名。

单击检查并提交，检查通过后完成自定义域名创建。

步骤三：配置自定义域名 CNAME

为上海主实例的自定义域名，配置指向广州备实例公网域名的解析记录。

登录云解析 DNS 控制台。

在左侧导航栏选择私网解析 PrivateZone > 私网域名管理，单击华东2（上海）地域的域名 test.cr-test.team。

在记录管理标签页上，单击添加记录。

在添加记录页面，填写基本信息和记录值。

参数	说明
域名	填写@，表示空值，直接解析主域名 test.cr-test.team。
记录类型	选择 CNAME，将自定义域名指向广州实例公网域名。
TTL	设置 DNS 记录的缓存有效期，保持默认设置即可。
记录值	填写自定义域名的解析记录，本示例为广州实例的公网域名 testmonitor-cn-guangzhou.cr.volces.com。

单击提交，完成记录添加。

步骤四：配置实例同步规则

在上海主实例中配置同步规则，确保镜像持续从上海主地域备份到广州容灾地域。

登录镜像仓库控制台，切换至华东 2（上海）地域。

在左侧导航栏选择实例同步，单击创建实例同步规则。

配置同步规则。

完成配置后，上海实例中推送到 test 命名空间的镜像，将自动同步至广州实例。

实例同步类型

参数
说明
同步类型
选择实例间同步，将标准版实例同步到本账号下其他标准版实例。

源实例

参数	说明
实例	选择需要同步的源标准版实例，本示例为 testmonitor。
命名空间	选择源实例下需要同步的命名空间名称，本示例为 test。
仓库	需要同步的 OCI 制品仓库名称，本示例选择全部，同步指定命名空间下的全部 OCI 制品仓库。
版本 Tag	需要同步的 OCI 制品版本，本示例选择全部，即同步指定仓库下的全部 OCI 制品版本。

目标实例

参数	说明
同步类型	选择主账号内。
地域	选择目标标准版实例所在的地域，本示例为华南1（广州）。
实例名	选择目标标准版实例，本示例为 testmonitor。
命名空间	选择目标实例下的命名空间，本示例为 test。

同步规则

参数	说明
镜像覆盖	勾选后启用。启用后若目标端存在与源端同名的镜像，则源端镜像会覆盖目标端已有同名镜像。
规则状态	选择事件驱动触发：有符合规则的事件产生时，自动触发同步。配置立即触发为是，在创建实例同步规则成功后，立即触发规则匹配，进行一次同步操作。

验证结果

在上海地域的主机上执行验证，确认自定义域名已指向广州实例，且能成功拉取镜像。

执行以下命令，解析出的域名已变为广州实例域名。

ping test.cr-test.team

执行结果：

通过自定义域名地址，能够成功拉取广州实例中的镜像。

# 拉取镜像，实际流量将流向广州备实例
docker pull test.cr-test.team/test/busybox:latest

执行结果：

最近更新时间：2026.08.24 10:38:22

这个页面对您有帮助吗？

有用

无用