泛域名接入
为每个用户的云开发环境提供独立的对外访问域名,是平台向用户交付可访问应用的关键一步。
平台版支持套餐级泛域名方案:平台在套餐上配置一个泛域名并提供泛域名证书后,每个环境只需添加一个子域名即可对外提供服务,无需重复上传证书;个别环境也可以绑定独立域名并配置独立证书。
泛域名配置
泛域名配置是一次性操作,由平台在套餐维度完成:
- 配置一个泛域名(例如
*.example.com),覆盖该域名下的所有子域名 - 提供一张泛域名证书(覆盖所有子域名),后续环境添加子域名时可直接继承该证书,无需再为每个环境上传
配置泛域名后,云开发会返回目标域名,需要前往对应的域名服务商控制台添加 CNAME 解析记录,把泛域名解析到该目标域名,之后该泛域名下的子域名即可对外访问。
配置完成后,平台即可为每个环境按需添加子域名(例如 env1.example.com、env2.example.com),所有子域名共用泛域名证书对外提供 HTTPS 访问。
环境子域名接入
用户申请环境时,您的系统按以下流程完成环境创建与域名接入:
整体分三步:
- 平台版接入泛域名(一次性)
- 为环境接入子域名,可继承泛域名的接入方式
- 为子域名添加访问路由
第一步 · 平台版接入泛域名(一次性)
在套餐维度接入泛域名并关联泛域名证书,拿到云开发返回的目标域名后,在 DNS 服务商处添加 CNAME 解析。完成后,该泛域名下的任意子域名都可以直接使用,无需再单独接入。
步骤见 泛域名接入 - 配置步骤(平台版)。
第二步 · 为环境接入子域名
用户申请环境时,先调用 创建环境 拿到环境 ID,再调用 CreateHTTPServiceRoute 为该环境接入子域名。
关键是把 AccessType 传 NONE:证书、CNAME 等接入方式直接继承平台版泛域名,不需要单环境上传证书,也不需要重复做归属权校验。必填参数与取值见接口文档。
不用继承方式也可以正常接入。泛域名证书覆盖所有子域名,多数场景无需额外配置;如果个别环境需要绑定独立域名(不限于套餐泛域名)或使用自有证书,把 AccessType 传常规接入方式(如 DIRECT)并指定该域名对应的独立证书,再按 自定义域名 - 开始接入 完成归属权校验、证书与 CNAME 解析即可。
这一步只完成“域名接入”,请求还没有指向任何业务资源。
第三步 · 为子域名添加访问路由
子域名接入后,必须再配置路由,明确“哪个路径转发到哪个资源”,否则请求匹配不到上游。
路由可以随域名一次性传入 Routes,也可以先接域名、之后用 ModifyHTTPServiceRoute 增量添加。路由的匹配优先级与配置方式见 路由匹配规则,按上游资源类型选择对应文档:
| 上游资源 | 配置指引 |
|---|---|
| 云函数 | 通过 HTTP 访问云函数 |
| 静态托管 | 通过 HTTP 访问静态托管 |
| 云托管 | 通过 HTTP 访问云托管 |
| 云存储 | 通过 HTTP 访问云存储 |
路由下发后,调用 DescribeHTTPServiceRoute 查询 Status 与 DNSStatus,均为 SUCCESS 即配置生效;随后用子域名实际访问一次确认。
相关接口
- 域名归属权校验:VerifyPlatformHTTPServiceRoute
- 创建 HTTP 网关域名 / 路由:CreateHTTPServiceRoute
- 修改 HTTP 网关域名 / 路由:ModifyHTTPServiceRoute
- 查询 HTTP 网关域名 / 路由:DescribeHTTPServiceRoute
- 删除 HTTP 网关域名 / 路由:DeleteHTTPServiceRoute
说明:泛域名与证书的具体配置方式,以云开发控制台及接口文档为准。
下一步
完成泛域名接入后,即可为每个环境签发访问凭证: