tcb domains add
把自定义域名绑定到 HTTP 网关。绑定后可通过自己的域名访问云开发资源，并用路由规则把流量转发到云函数、云托管、静态托管等上游服务。
v3.0.0+
tcb domains 自 v3.0.0 起提供。
语法
tcb domains add <domain> --certid <certId> [options]
参数
| 参数 | 必填 | 说明 | 默认值 |
|---|---|---|---|
<domain> | 是 | 要绑定的域名 | — |
--certid <certId> | 是 | SSL 证书 ID，在腾讯云 SSL 证书控制台获取 | — |
--access-type <type> | 否 | 接入方式：DIRECT / CDN / CUSTOM / EO | DIRECT |
--custom-cname <cname> | 否 | 自定义 CNAME，仅 --access-type CUSTOM 时可用 | — |
--disable | 否 | 绑定后禁用域名 | false |
-e, --env-id <envId> | 否 | 环境 ID | 配置文件 envId |
--platform-id <platformId> | 否 | 平台版资源池 ID，与 -e 互斥（v3.8.3+） | — |
示例
# 直连接入（默认）
tcb domains add api.example.com --certid <certId> -e <envId>
# CDN 接入
tcb domains add api.example.com --certid <certId> --access-type CDN -e <envId>
# 自定义接入，需指定 CNAME 源站
tcb domains add api.example.com --certid <certId> --access-type CUSTOM --custom-cname origin.example.com -e <envId>
# 绑定后禁用
tcb domains add api.example.com --certid <certId> --disable -e <envId>
# 平台版资源池下绑定（v3.8.3+）
tcb domains add api.example.com --certid <certId> --platform-id <platformId>
前置条件
- 域名已完成 ICP 备案
- 已在腾讯云 SSL 证书控制台 申请并上传有效证书，取得证书 ID
- 绑定成功后，把域名的 DNS CNAME 记录指向云开发环境域名
注意事项
- 同一域名不能重复绑定
- 绑定成功后需配置 DNS CNAME 解析才能正常访问
- 绑定域名后才有路由可挂载，见创建路由