跳到主要内容

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

已废弃​

tcb service 自 v3.0.0 起废弃,保留向后兼容但不再维护。

命令行为替代
tcb service create创建 HTTP 网关路径tcb routes add
tcb service delete删除 HTTP 网关路径tcb routes delete
tcb service list查询 HTTP 网关路径tcb routes list
tcb service switch开关 HTTP 网关tcb routes edit(enable 字段,按路由开关)
tcb service auth switch开关 HTTP 网关鉴权tcb routes edit
tcb service domain bind绑定自定义域名tcb domains add
tcb service domain unbind解绑自定义域名tcb domains rm
tcb service domain list查询自定义域名tcb domains ls