跳到主要内容

自定义域名

CloudBase HTTP 访问服务默认提供自动生成的域名，您也可以将自定义域名绑定至 CloudBase HTTP 访问服务。

💡 注意：默认域名建议您只在测试环境中使用。为保障业务的安全性和稳定性，生产环境建议绑定自定义域名。

前置准备​

在开始配置自定义域名前，请确保已完成以下准备工作：

  1. 域名备案：完成 ICP 备案，详情参考 ICP 备案页
  2. SSL 证书：准备 SSL 证书，可在 SSL 证书控制台 上传

第 1 步：添加域名​

  1. 进入 云开发平台/HTTP 访问服务
  2. 点击「添加域名」
  3. 填写自定义域名并配置 SSL 证书
  4. 选择 CDN 类型

CDN 类型选择​

创建自定义域名时，您可以选择以下三种 CDN 类型：

  • 不使用 CDN：适用于云托管或云函数服务
  • 云开发 CDN：适用于静态托管或自定义应用
  • 自定义 CDN：当云开发 CDN 无法满足需求时使用

云开发 CDN​

选择 云开发 CDN 时，系统会自动为您配置 CDN 加速服务。

自定义 CDN​

选择 自定义 CDN 时，需要按以下步骤操作：

  1. 复制「回源域名」
  1. 前往 CDN 控制台，在域名对应源站配置中填入回源域名并保存

💡 注意：使用腾讯云 CDN 时，需要将 CDN 控制台生成的 CNAME 填写到自定义域名 CNAME 位置，云开发将对您的域名所有权进行校验。

第 2 步：配置域名 CNAME 解析记录​

  1. 前往您的域名服务商后台
  2. 找到域名解析记录页面
  3. 添加 CNAME 记录
提示

CNAME 记录值根据您选择的 CDN 类型确定：

  • 选择云开发 CDN：使用 HTTP 访问服务提供的 CNAME
  • 选择自定义 CDN：使用 CDN 控制台提供的 CNAME :::

第 3 步：等待域名生效​

添加 CNAME 记录后，通常需要等待 5-30 分钟让 DNS 解析生效。您可以通过以下命令检查域名解析是否已生效：

nslookup 您的自定义域名

如果返回结果中显示了 CloudBase 提供的 CNAME 域名，则表示解析已生效。

修改 CDN 类型​

域名绑定后，如需修改 CDN 类型，可按以下步骤操作：

  1. 在域名列表中找到目标域名
  2. 点击「修改 CDN」
  3. 按照页面指引完成配置

⚠️ 注意：修改 CDN 类型后，需要手动修改 DNS 解析记录，新的 CDN 配置才能正式生效。

使用限制​

  • 每个 CloudBase 环境最多可绑定 5 个自定义域名
  • 自定义域名必须已完成 ICP 备案
  • 域名解析生效需要一定时间，请耐心等待

腾讯云 DNS 设置方法​

如果您的 DNS 服务商为腾讯云，可按以下步骤添加 CNAME 记录：

  1. 登录 域名服务控制台
  2. 在域名列表中找到目标域名，点击操作栏的「解析」
  1. 在解析页面中，点击「添加记录」
  1. 配置解析记录：
    • 主机记录：填写域名前缀（例如：@）
    • 记录类型：选择 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

常见问题​

为什么自定义域名无法访问？​

请按以下步骤排查问题：

  1. 检查域名备案：确认域名是否已完成 ICP 备案
  2. 验证解析配置：确认 CNAME 解析记录是否配置正确
  3. 测试 DNS 解析：使用 nslookup 命令检查 DNS 解析是否已生效
  4. 检查 SSL 证书：如使用 HTTPS，确认 SSL 证书是否配置正确

如何更新已绑定域名的 SSL 证书？​

  1. 进入 云开发平台/HTTP 访问服务
  2. 找到已绑定的域名，点击「编辑」
  3. 更新 SSL 证书配置并保存

如何删除已绑定的自定义域名？​

  1. 进入 云开发平台/HTTP 访问服务
  2. 找到需要删除的域名，点击「删除」
  3. 确认删除操作

⚠️ 注意：删除后，该域名将无法再访问您的 CloudBase 服务。

如何将自定义 CDN 切换到云开发 CDN？​

  1. 点击「修改 CDN 类型」，选择云开发 CDN，修改后会生成新的 CNAME 域名
  2. 如果云开发控制台提示"该域名在 CDN 已经存在，请前往静态网站托管或 CDN 控制台删除后再重新绑定"，需要您在 CDN 控制台删除域名后再操作
  3. 修改 DNS 解析到新的 CNAME 域名

⚠️ 注意：删除域名后会导致您的服务访问异常，请谨慎操作。

如何将云开发 CDN 无损切换到自定义 CDN？​

目前暂不支持，如需无损切换，请联系我们。

如何将腾讯云自定义 CDN 无损切换到云开发 CDN？​

  1. 点击「修改 CDN 类型」，选择不使用 CDN，修改后会重新生成 CNAME 域名
  2. 人工确认访问正常后修改 DNS 解析到不使用 CDN 的 CNAME 域名
  3. 删除腾讯云自定义 CDN
  4. 点击「修改 CDN 类型」，选择云开发 CDN，修改后会重新生成 CNAME 域名
  5. 人工确认访问正常后修改 DNS 解析到云开发 CDN 的 CNAME 域名

如何在修改 DNS 解析前人工检查访问是否正常？​

  1. 配置域名关联资源
  2. 配置 TXT 解析，详细配置参考：配置域名 TXT 解析记录
  3. 本地使用 curl 访问资源路径，查看返回结果是否正确
# HTTP 访问探测
curl -v --resolve [www.example.com]:80:[cname.domain] http://www.example.com/[your-path]

# HTTPS 访问探测
curl -v --resolve [www.example.com]:443:[cname.domain] https://www.example.com/[your-path]

参数说明：

  • www.example.com：替换为您的自定义域名
  • cname.domain：替换为您的 CNAME 域名
  • your-path：替换为您的资源访问路径