跳到主要内容

tcb env access set

修改环境默认域名的访问来源:公网访问、VPC 访问与 VPC 白名单。

仅企业版和平台版套餐支持,命令自 v3.9.4 起提供。只下发本次指定的项,未指定的来源保持当前值。

语法​

tcb env access set [options]

参数​

公网访问:

参数说明
--enable-public-access放通公网访问
--disable-public-access拦截公网访问,默认域名对公网请求返回 403

VPC 访问:

参数说明
--enable-vpc-access放通 VPC 访问
--disable-vpc-access拦截 VPC 访问

VPC 白名单:

参数说明
--vpc-whitelist <vpcs...>设置白名单列表,整体覆盖。格式 vpcId@region,逗号分隔或重复传参
--enable-vpc-whitelist开启白名单,按当前列表放通
--disable-vpc-whitelist关闭白名单,列表保留,放通所有 VPC
白名单行为
  • --vpc-whitelist 只替换列表,不改变白名单开关
  • 开启白名单但列表为空,等于拦截全部 VPC
  • VPC 访问为 CLOSE 时,白名单不生效

确认​

变更前展示当前值与目标值,默认需要二次确认。--yes 跳过确认,--json 下必须带 --yes。

示例​

# 关闭公网访问
tcb env access set -e env-xxx --disable-public-access --yes

# 开启 VPC 访问并设置白名单
tcb env access set -e env-xxx --enable-vpc-access --enable-vpc-whitelist \
--vpc-whitelist vpc-aaa@ap-shanghai,vpc-bbb@ap-guangzhou

# 只替换白名单列表
tcb env access set -e env-xxx --vpc-whitelist vpc-ccc@ap-beijing

# 关闭白名单,放通所有 VPC
tcb env access set -e env-xxx --disable-vpc-whitelist

# 以 JSON 格式输出
tcb env access set -e env-xxx --disable-public-access --yes --json