跳到主要内容

tcb routes / tcb domains / tcb cors

管理 HTTP 网关的访问入口:路由规则决定请求转发到哪个上游服务,自定义域名提供访问地址,安全域名控制 Web SDK 可以访问的网页来源。

命令索引​

网关路由​

命令用途
tcb routes list查看路由列表,支持按域名、上游服务类型过滤
tcb routes add创建路由,可绑定云函数、云托管或静态托管
tcb routes edit增量修改路由的转发规则与鉴权配置
tcb routes delete删除路由

自定义域名​

命令用途
tcb domains ls查看自定义域名列表
tcb domains add绑定自定义域名,支持直连、CDN、自定义与 EO 接入
tcb domains edit更新证书、接入方式等域名配置
tcb domains rm解绑自定义域名
tcb domains cache purge提交 CDN 或 EO 缓存刷新任务
tcb domains cache task查询刷新任务进度与历史

安全域名​

命令用途
tcb cors list查看安全域名列表
tcb cors add添加安全域名
tcb cors rm删除安全域名

参考​

文档内容
配置文件-网关cloudbaserc.json 的 gateway.routes 字段
转发版本路由的 upstreamResourceVersion 字段语义,用于把流量切到指定函数或云托管版本

说明​

  • 安全域名(tcb cors)管理 Web SDK 的 CORS 白名单;自定义域名(tcb domains)是 HTTP 网关的访问域名,需绑定 SSL 证书并与路由联动
  • 命令式创建路由要求域名已通过 tcb domains add 绑定;tcb deploy 会按 gateway.routes 自动绑定域名
  • 域名相关命令支持 --platform-id <platformId> 操作平台版资源池(v3.8.3+),缓存刷新不支持平台版
  • 缓存刷新用 tcb domains cache,不是 tcb routes