自定义域名
CloudBase HTTP 访问服务默认提供自动生成的域名,您也可以将自定义域名绑定至 CloudBase HTTP 访问服务。
💡 注意:默认域名建议您只在测试环境中使用。为保障业务的安全性和稳定性,生产环境建议绑定自定义域名。
前置准备
在开始配置自定义域名前,请确保已完成以下准备工作:
添加域名
- 进入 云开发平台/HTTP 访问服务
 - 点击「添加域名」
 - 填写自定义域名并配置 SSL 证书
 - 选择 CDN 类型
 
CDN 类型选择
创建自定义域名时,您可以选择以下三种 CDN 类型:
- 不使用 CDN:适用于主云托管或云函数服务等无需CDN场景
 - 云开发 CDN:适用于静态托管或自定义应用,系统会自动为您配置 CDN 加速服务
 - 自定义 CDN:当云开发 CDN 无法满足需求时,您可以使用 自定义CDN 来加速您的服务
 
⚠️ 注意:该CDN用于静态网站托管等资源,若希望给云存储添加CDN,请参考云存储自定义CDN
自定义 CDN 配置流程
选择 自定义 CDN 时,需要按以下步骤操作:
第 1 步:配置回源域名
- 复制「回源域名」
 

- 前往 CDN 控制台,点击「添加域名」
 

- 粘贴「回源域名」
 

- 复制 CDN 控制台 中的 CNAME 值到「自定义CDN CName」中
 
⚠️ 注意:使用腾讯云 CDN 时,需要将 CDN 控制台生成的 CNAME 填写到自定义域名 CNAME 位置,云开发将对您的域名所有权进行校验。
第 2 步:配置域名 CNAME 解析记录
- 前往您的域名服务商后台
 - 找到域名解析记录页面
 - 添加 CNAME 记录
 
CNAME 记录值根据您选择的 CDN 类型确定:
- 选择云开发 CDN:使用 HTTP 访问服务提供的 CNAME
 - 选择自定义 CDN:使用 CDN 控制台提供的 CNAME
 

第 3 步:等待域名生效
添加 CNAME 记录后,通常需要等待 5-30 分钟让 DNS 解析生效。您可以通过以下命令检查域名解析是否已生效:
nslookup 您的自定义域名
如果返回结果中显示了 CloudBase 提供的 CNAME 域名,则表示解析已生效。
修改 CDN 类型
域名绑定后,如需修改 CDN 类型,可按以下步骤操作:
- 在域名列表中找到目标域名
 - 点击「修改 CDN」
 - 按照页面指引完成配置
 

⚠️ 注意:修改 CDN 类型后,需要手动修改 DNS 解析记录,新的 CDN 配置才能正式生效。
使用限制
- 每个 CloudBase 环境最多可绑定 5 个自定义域名
 - 自定义域名必须已完成 ICP 备案
 - 域名解析生效需要一定时间,请耐心等待
 
腾讯云 DNS 设置方法
如果您的 DNS 服务商为腾讯云,可按以下步骤添加 CNAME 记录:
- 登录 域名服务控制台
 - 在域名列表中找到目标域名,点击操作栏的「解析」
 

- 在解析页面中,点击「添加记录」
 

- 配置解析记录:
- 主机记录:填写域名前缀(例如:@)
 - 记录类型:选择 CNAME
 - 记录值:填写 CNAME 值
 - 点击「保存」完成配置
 
 
域名解析各种记录类型之间存在优先级差异。在主机记录相同的情况下,同一条线路的不同记录类型不能共存,否则会提示冲突。CNAME 记录与除 CNAME 记录以外的任何记录类型都冲突,需要先删除其他记录再进行配置。详情请参见 为什么添加解析记录的时候提示"记录有冲突"。
域名所有权校验
为了确认您确实具有域名的所有权,您可以选择以下任意一种方式进行域名所有权校验:
- 配置域名 CNAME 解析记录
 - 配置域名 TXT 解析记录
 - 配置特定子域名的 TXT 解析记录
 
选择一:配置域名 CNAME 解析记录
将您域名的 CNAME 配置为 CloudBase 控制台上提供的域名。
例如,您的域名为 foo.com,您可以将域名的 CNAME 记录设置为 foo.com.cdn.dnsv1.com
选择二:配置域名 TXT 解析记录
将您域名的 TXT 解析记录配置为所属的 CloudBase 环境 ID。
例如,您的域名为 foo.com,环境 ID 为 bar-12345,您可以将 foo.com 的 TXT 记录设置为 bar-12345
选择三:配置特定子域名的 TXT 解析记录
将您域名的特定子域名 _cloudbase-challenge 的 TXT 解析记录配置为所属的 CloudBase 环境 ID。
例如,您的域名为 foo.com,环境 ID 为 bar-12345,您可以将 _cloudbase-challenge.foo.com 的 TXT 记录设置为 bar-12345