文档中心

镜像仓库

域名

域名概述

镜像仓库为每个实例提供系统域名和默认域名，同时支持绑定自定义域名。本文介绍各类域名的区别和使用场景，帮助您选择合适的域名访问实例。

说明

本功能仅适用于标准版实例。

域名类型

说明

系统域名和默认域名均可用于 docker login、docker push、docker pull 等操作，效果一致。

如果实例名称发生变更，默认域名不会自动更新。建议在自动化脚本中优先使用系统域名，避免因实例改名导致访问中断。

域名类型	格式	说明	典型使用场景	是否可修改
系统域名	[实例名称]-[地域].cr.volces.com	实例创建时由系统自动分配，基于实例名称和地域生成，是实例的唯一标识域名。支持内网访问和公网访问。	CI/CD 流水线、自动化脚本。系统域名固定不变，适合写入配置文件长期使用。	不可修改
自定义域名	用户自定义，例如 cr.example.com	用户自行绑定的域名，需要在 DNS 服务商处配置 CNAME 解析。适用于企业统一域名管理、隐藏实例 ID 等场景。	企业统一域名规范、域名迁移无感切换。更换域名时只需要修改 DNS 解析，已有配置无需修改。	可添加和删除
默认域名	[实例名称]-[地域].cr.volces.com 或 [自定义域名]	实例创建时默认域名等同于系统域名。支持通过设置默认域名功能切换为其他已绑定的自定义域名，切换后控制台实例设置说明中展示的命令将使用新的默认域名。	控制台操作统一展示。设置为自定义域名后，团队成员复制推拉命令时自动使用该域名。	可设置

使用示例

以下示例展示如何使用不同类型的域名登录实例并推拉镜像。

使用系统域名

docker login [实例名称]-[地域].cr.volces.com --username [用户名] --password [密码]​
docker pull [实例名称]-[地域].cr.volces.com/[命名空间]/[仓库名称]:[标签]​

使用自定义域名

创建自定义域名并完成 DNS 解析配置后，可以直接使用自定义域名替代系统域名执行所有操作：

docker login cr.example.com --username [用户名] --password [密码]​
docker push cr.example.com/[命名空间]/[仓库名称]:[标签]​
docker pull cr.example.com/[命名空间]/[仓库名称]:[标签]​

设置默认域名的效果

将默认域名设置为自定义域名后：

控制台实例设置说明中展示的命令将自动使用该自定义域名。

团队成员在控制台复制推拉命令时，获取到的镜像地址统一为自定义域名，无需手动替换。

已有脚本中使用系统域名或旧默认域名的配置仍然有效，不受影响。

操作	说明
创建自定义域名	为 CR 实例绑定自定义域名，并配置 DNS 解析。
管理自定义域名	查看、修改或删除已绑定的自定义域名。
设置默认域名	将已绑定的自定义域名设置为实例的默认域名。
查看 TrafficRoute 解析记录	查看实例域名在 TrafficRoute 中的 DNS 解析记录。
添加公网访问解析记录	为实例域名添加公网解析记录，使外部网络可以通过域名访问实例。