跳到主要内容

自定义域名

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

生产环境建议绑定已完成备案的自定义域名以获得完整的服务能力和稳定性保障。默认域名的相关限制与适用说明，请参阅 HTTP 网关概述 - 默认域名。

前置准备​

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

资源点模式要求

边缘加速按资源点计费，若当前环境未处于资源点模式，需先进入 云开发控制台 → 套餐用量 将计费模式转换为资源点模式后方可开启边缘加速。

  1. 域名备案 准备 自定义域名，并完成 ICP 备案。

    提示

    也可直接使用云开发环境完成备案，前往 云开发平台 - 备案管理。

  2. SSL 证书 准备 SSL 证书，可在 SSL 证书控制台 上传或申请。

域名归属权校验​

域名首次接入云开发网关时，需要通过域名归属权校验确认您确实拥有该域名，避免域名被他人误用或冒用接入，保障您的业务安全。

校验方式为在 DNS 服务商处添加一条 TXT 解析记录，具体记录值会在域名接入的操作过程中提供，请按页面指引添加即可。

添加域名时，页面会引导您完成 TXT 记录校验，例如：

绑定自定义域名页面指引
开启边缘加速的归属权校验

如果开启了 边缘加速，首次开启时还需要验证 EdgeOne 域名归属权。这是 EdgeOne 平台自身的要求，与云开发的首次域名归属权校验不通用，需按 EdgeOne 指引添加对应的 DNS TXT 记录完成校验。

开始接入​

  1. 进入云开发平台 - HTTP 网关
  2. 点击「添加域名」
  3. 填写自定义域名并配置 SSL 证书
  4. 选择接入方式

添加自定义域名入口

提示

除了在 HTTP 网关统一管理域名外，您也可以在具体的 云函数 / 云托管 / 静态托管应用 详情页中，就地为该应用添加自定义域名。两种入口效果一致，HTTP 网关可查看并管理所有已添加的域名。

接入方式​

自定义域名支持以下两种接入方式：

  • 云开发接入：由云开发平台统一管理域名接入，可选择开启或关闭边缘加速
  • 自定义接入：使用您自己的 CDN 或 WAF 服务接入

云开发接入​

云开发接入支持「开启边缘加速」和「不开启边缘加速」两种方式。

开启边缘加速​

开启边缘加速后，CloudBase 将通过 EdgeOne 边缘节点就近接入您的访问请求，由边缘节点完成请求的就近响应，从而降低访问延迟、提升访问速度，并提供边缘层的安全防护能力。

边缘加速依托 EdgeOne 全球边缘节点，覆盖 70+ 国家与地区，海外用户也能就近接入。开启后将产生加速流量费用与加速请求次数两项费用，按访问来源大区计费。具体价格请参考 云开发计费文档。

后续步骤​
  1. 完成 EdgeOne 域名归属权校验：首次开启边缘加速时，需要验证 EdgeOne 域名归属权，按指引添加对应的 DNS TXT 记录即可。
  1. 配置 CNAME 解析：域名接入状态正常后，前往 DNS 控制台 配置 CNAME 解析，CNAME 的值会在页面上提供。
说明

由于边缘加速底层使用 EdgeOne，实际接入时 EdgeOne 下发配置需要一定时间。验证 EdgeOne 归属权后的处理状态约需 10-20 分钟，请耐心等待。

不开启边缘加速​

不开启边缘加速时，直接走云开发网关。

第 1 步：云开发平台添加自定义域名​

在 HTTP 网关 添加自定义域名并选择云开发接入（不开启边缘加速）

第 2 步：等待域名关联完成​

在云开发平台添加自定义域名后，需要等待域名关联完成，通常需要等待 3-5 分钟，域名关联成功后，复制 CNAME 值。

第 3 步：DNS 控制台并添加 CNAME 解析​

用步骤 2 中复制的 CNAME 值，前往域名 DNS 服务商添加 CNAME 记录，将请求切入 CDN，域名才能生效，前往 DNS 控制台，添加域名解析记录。

第 4 步：完成云开发接入​

返回云开发平台，检查自定义域名接入状态

说明

如果自定义域名接入状态未更新，可刷新网页再查看。

存量云开发 CDN 迁移到边缘加速​
说明

原「云开发 CDN」接入方式已不再支持。如果您之前使用的是云开发 CDN 接入的域名，建议迁移到云开发接入（开启边缘加速），借助 EdgeOne 能力获得更好的访问体验。

  1. 在域名管理页面，找到原域名，点击「编辑」，将接入方式改为 云开发接入，并 开启边缘加速 后保存。
  2. 首次开启边缘加速，需要验证 EdgeOne 域名归属权，操作过程中按指引添加对应的 DNS TXT 记录即可。
  3. 修改完接入方式，等状态正常后，前往 DNS 解析控制台，将域名 CNAME 指向新创建的 CNAME 值。

自定义接入​

CDN 接入​
第 1 步：云开发平台添加自定义域名​

在HTTP 网关添加自定义域名并选择自定义 CDN，并复制回源域名

第 2 步：添加 CDN 域名​

前往 CDN 控制台，点击「添加域名」。

第 3 步：CDN 域名配置​

1. 配置源站域名：添加域名配置，粘贴步骤 1 中复制的回源域名到源站域名地址中。

说明

请根据业务类型自主选择加速区域和加速类型。

2. 填写推荐配置：提升加速性能。

说明

若无需额外配置，该步可选择跳过。

3. 添加 CNAME 解析：复制 CDN 控制台中的 CNAME 值，前往 DNS 控制台添加 CNAME 类型解析。

说明

DNS 解析需要前往对应的域名服务商控制台添加 CNAME 解析记录。

4. 完成配置：完成自定义 CDN 配置

第 4 步：校验 CDN 域名接入​

添加 CNAME 记录后，通常需要等待 5-30 分钟让 DNS 解析生效。并返回云开发平台查看自定义 CDN 接入状态。您可以通过以下命令检查域名解析是否已生效：

nslookup 您的自定义域名

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

WAF 接入​

WAF（Web 应用防火墙）接入流程与自定义 CDN 接入类似，区别在于：需要在 WAF 控制台完成源站配置后，将 WAF 分配的 CNAME 回填到云开发平台，再在 DNS 服务商处添加 CNAME 解析。

第 1 步：云开发平台添加自定义域名​

在 HTTP 网关 添加自定义域名并选择自定义 CDN，并复制回源域名。

第 2 步：添加 WAF 域名​

前往 Web 应用防火墙控制台，在「接入管理」中点击「添加域名」。

第 3 步：配置 WAF 源站域名​

在新添加的域名行点击「编辑」，将「源站地址」类型选择为「域名」，并把第 1 步中复制的云开发回源域名粘贴到源站地址中。

说明

源站域名示例：xxxxxx-1234567890.ap-shanghai.service.tcloudbase.com，请以控制台实际展示为准。

第 4 步：获取 WAF CNAME 并回填至云开发​
  1. 在 WAF 域名列表的「CNAME」列，复制 WAF 分配的 CNAME 值。
  1. 返回 HTTP 网关，在对应域名的「CNAME」输入框中，粘贴 WAF 分配的 CNAME 值并保存。
第 5 步：DNS 控制台添加 CNAME 解析​

将域名的 CNAME 解析指向 WAF 分配的 CNAME 值，前往 DNS 控制台 添加 CNAME 记录。

说明

DNS 解析需要前往您域名实际所在的 DNS 服务商控制台添加 CNAME 解析记录，腾讯云 DNS 添加方法可参考本文档末尾的「腾讯云 DNS 设置方法」。

第 6 步：校验 WAF 域名接入​

添加 CNAME 记录后，通常需要等待 5-30 分钟让 DNS 解析生效。返回云开发平台查看 WAF 域名接入状态。您可以通过以下命令检查域名解析是否已生效：

nslookup 您的自定义域名

如果返回结果中显示了 WAF 分配的 CNAME 域名，则表示解析已生效。

腾讯云 DNS 设置方法​

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

1. 进入域名解析

登录 域名服务控制台，在域名列表中找到目标域名，点击操作栏的「解析」。

2. 添加解析记录

在解析页面中，点击「添加记录」。

3. 配置解析记录

配置解析记录参数：

  • 主机记录：填写域名前缀（例如：@）
  • 记录类型：选择 CNAME
  • 记录值：填写 CNAME 值
  • 点击「保存」完成配置
提示

域名解析各种记录类型之间存在优先级差异。在主机记录相同的情况下，同一条线路的不同记录类型不能共存，否则会提示冲突。CNAME 记录与除 CNAME 记录以外的任何记录类型都冲突，需要先删除其他记录再进行配置。详情请参见 为什么添加解析记录的时候提示"记录有冲突"。

使用限制​

  • 每个 CloudBase 环境最多可绑定的自定义域名数量根据套餐不同有所差异，具体请参考 套餐配额与能力项说明
  • 自定义域名必须已完成 ICP 备案
  • 域名解析生效需要一定时间，请耐心等待