泛域名接入
为每个用户的云开发环境提供独立的对外访问域名,是平台向用户交付可访问应用的关键一步。
平台版支持套餐级泛域名方案:平台在套餐上配置一个泛域名并提供泛域名证书后,每个环境只需添加一个子域名即可对外提供服务,无需重复上传证书;个别环境也可以绑定独立域名并配置独立证书。
泛域名配置
泛域名配置是一次性操作,由平台在套餐维度完成:
- 配置一个泛域名(例如
*.example.com),覆盖该域名下的所有子域名 - 提供一张泛域名证书(覆盖所有子域名),后续环境添加子域名时自动生效,无需再为每个环境上传证书
配置泛域名后,云开发会返回目标域名,需要前往对应的域名服务商控制台添加 CNAME 解析记录,把泛域名解析到该目标域名,之后该泛域名下的子域名即可对外访问。
配置完成后,平台即可为每个环境按需添加子域名(例如 env1.example.com、env2.example.com),所有子域名共用泛域名证书对外提供 HTTPS 访问。
环境子域名接入
用户申请环境时,您的系统按以下流程完成环境创建与域名接入:
- 创建环境:用户申请环境后,您的系统调用云开发创建环境,详见 创建环境
- 添加子域名与路由:环境创建成功后,调用云开发接口为环境添加自定义域名(使用套餐泛域名的子域名)与路由配置,子域名自动复用泛域名证书
- 返回给用户:将环境 ID 与子域名返回给用户
独立证书(可选)
泛域名证书覆盖所有子域名,多数场景无需额外配置。如需个别环境使用独立域名或自有证书,可:
- 为环境绑定独立域名(不限于套餐泛域名)
- 配置该域名对应的独立证书,替代泛域名证书
相关接口
- 创建 HTTP 网关域名 / 路由:CreateHTTPServiceRoute
- 修改 HTTP 网关域名 / 路由:ModifyHTTPServiceRoute
- 查询 HTTP 网关域名 / 路由:DescribeHTTPServiceRoute
- 删除 HTTP 网关域名 / 路由:DeleteHTTPServiceRoute
- 绑定静态托管域名:CreateHostingDomain
- 查询静态托管域名任务状态:DescribeHostingDomainTask
说明:泛域名与证书的具体配置方式,以云开发控制台及接口文档为准。
下一步
完成泛域名接入后,即可为每个环境签发访问凭证: