跳到主要内容

泛域名接入

为每个用户的云开发环境提供独立的对外访问域名,是平台向用户交付可访问应用的关键一步。

平台版支持套餐级泛域名方案:平台在套餐上配置一个泛域名并提供泛域名证书后,每个环境只需添加一个子域名即可对外提供服务,无需重复上传证书;个别环境也可以绑定独立域名并配置独立证书。

泛域名配置​

泛域名配置是一次性操作,由平台在套餐维度完成:

  • 配置一个泛域名(例如 *.example.com),覆盖该域名下的所有子域名
  • 提供一张泛域名证书(覆盖所有子域名),后续环境添加子域名时可直接继承该证书,无需再为每个环境上传

配置泛域名后,云开发会返回目标域名,需要前往对应的域名服务商控制台添加 CNAME 解析记录,把泛域名解析到该目标域名,之后该泛域名下的子域名即可对外访问。

配置完成后,平台即可为每个环境按需添加子域名(例如 env1.example.com、env2.example.com),所有子域名共用泛域名证书对外提供 HTTPS 访问。

环境子域名接入​

用户申请环境时,您的系统按以下流程完成环境创建与域名接入:

整体分三步:

  1. 平台版接入泛域名(一次性)
  2. 为环境接入子域名,可继承泛域名的接入方式
  3. 为子域名添加访问路由

第一步 · 平台版接入泛域名(一次性)​

在套餐维度接入泛域名并关联泛域名证书,拿到云开发返回的目标域名后,在 DNS 服务商处添加 CNAME 解析。完成后,该泛域名下的任意子域名都可以直接使用,无需再单独接入。

步骤见 泛域名接入 - 配置步骤(平台版)。

第二步 · 为环境接入子域名​

用户申请环境时,先调用 创建环境 拿到环境 ID,再调用 CreateHTTPServiceRoute 为该环境接入子域名。

关键是把 AccessType 传 NONE:证书、CNAME 等接入方式直接继承平台版泛域名,不需要单环境上传证书,也不需要重复做归属权校验。必填参数与取值见接口文档。

不用继承方式也可以正常接入。泛域名证书覆盖所有子域名,多数场景无需额外配置;如果个别环境需要绑定独立域名(不限于套餐泛域名)或使用自有证书,把 AccessType 传常规接入方式(如 DIRECT)并指定该域名对应的独立证书,再按 自定义域名 - 开始接入 完成归属权校验、证书与 CNAME 解析即可。

这一步只完成“域名接入”,请求还没有指向任何业务资源。

第三步 · 为子域名添加访问路由​

子域名接入后,必须再配置路由,明确“哪个路径转发到哪个资源”,否则请求匹配不到上游。

路由可以随域名一次性传入 Routes,也可以先接域名、之后用 ModifyHTTPServiceRoute 增量添加。路由的匹配优先级与配置方式见 路由匹配规则,按上游资源类型选择对应文档:

上游资源配置指引
云函数通过 HTTP 访问云函数
静态托管通过 HTTP 访问静态托管
云托管通过 HTTP 访问云托管
云存储通过 HTTP 访问云存储

路由下发后,调用 DescribeHTTPServiceRoute 查询 Status 与 DNSStatus,均为 SUCCESS 即配置生效;随后用子域名实际访问一次确认。

相关接口​

说明:泛域名与证书的具体配置方式,以云开发控制台及接口文档为准。

下一步​

完成泛域名接入后,即可为每个环境签发访问凭证:

→ API Key 管理