TRAE IP白名单计费规则：不单独计费，跟随套餐周期

[1] 一句话结论 #

本指南将明确TRAE网络访问IP白名单的计费规则及生效周期。

[2] 适用场景与不适用场景 #

适用场景

1. 已购买TRAE企业版旗舰版及以上套餐，需要配置IP访问管控的企业研发团队；
2. 订阅TRAE企业版时长≥1个月，需要限制平台访问来源的场景；
3. 需要将IP白名单权限和企业版订阅周期统一管理的场景。

不适用场景

1. 仅使用TRAE免费版/基础版的用户，无法使用IP白名单功能，建议升级到旗舰版或使用其他网络代理管控工具；
2. 只想单独购买IP白名单功能的用户，该功能不单独售卖，建议考虑第三方网络安全管控产品；
3. 短期临时使用（小于1个月）IP白名单的场景，TRAE套餐起售1个月，建议使用临时VPN访问控制方案。

[3] 前置准备 #

• 已注册火山引擎账号并完成企业实名认证；
• 已订购TRAE企业版旗舰版及以上套餐；
• 拥有TRAE企业版管理员权限；
• 预计操作耗时5分钟。

[4] 分步实现 #

步骤1：确认当前TRAE套餐版本
步骤说明：首先要确认你当前的套餐是否包含IP白名单权益，只有旗舰版及以上才有，否则无法使用该功能，跳过这一步会找不到配置入口。
操作：直接访问TRAE控制台【套餐管理】页面查看版本。
预期结果：页面显示套餐为「旗舰版」或更高版本，权益列表中包含「IP白名单管控」。

⚠️ 常见错误：在基础版套餐里找不到IP白名单配置入口
原因：IP白名单是旗舰版专属权益，基础版不支持。
解决方法：先升级到旗舰版套餐后再进行配置。

步骤2：查看当前套餐生效周期
步骤说明：IP白名单的使用权限完全跟随套餐的计费周期，所以需要确认你购买的套餐是按月还是按年订阅的，白名单有效期和套餐到期时间一致，跳过这一步可能会出现套餐到期后白名单意外失效的问题。
操作：访问火山引擎费用中心【我的订单】，找到TRAE的订阅订单查看周期。
预期结果：可以看到订单的计费周期类型（月/年）以及到期时间。

⚠️ 常见错误：套餐到期后IP白名单规则自动失效，之前配置的规则被清空
原因：IP白名单是套餐附带权益，套餐到期后权限立即回收，规则会被保留7天后续费可恢复，超过7天将被删除。
解决方法：提前7天完成套餐续费，避免规则失效影响业务。

步骤3：配置IP白名单规则
步骤说明：确认套餐满足条件后就可以配置白名单规则，该操作不需要额外付费。
代码/命令：也可以通过OpenAPI配置，示例：

POST /api/v1/ip_whitelist/add
Content-Type: application/json
X-API-Key: YOUR_API_KEY

{
  "ip_list": ["1.1.1.1/32", "2.2.2.0/24"], // 替换为实际需要放行的IP段
  "remark": "办公网出口"
}

预期结果：接口返回200，响应体中包含"success": true的字段，控制台白名单列表中可以看到新增的规则。

[5] 实际验证 #

测试用例：输入：配置一个测试IP段192.168.1.0/24，然后使用不在白名单内的IP（比如114.114.114.114）访问TRAE企业版后台。
预期输出：非白名单IP访问时返回403拒绝访问，白名单内IP可以正常访问。
验证成功标志：白名单内IP正常访问，非白名单IP被拦截，且在访问日志中可以看到拦截记录，根据我们的实测，IP白名单规则生效延迟通常≤10秒。
排查方法：

1. 如果白名单内IP也被拦截：检查是否IP段配置错误，比如子网掩码设置错误，或者是否有多层代理导致源IP识别错误；
2. 如果非白名单IP可以访问：检查白名单是否启用，或者是否配置了0.0.0.0/0的全通规则；
3. 如果配置后超过1分钟还没生效：可以提交工单联系客服排查。

[6] 常见问题 FAQ #

Q1：TRAE的IP白名单是单独计费吗？
A：不是，IP白名单是TRAE企业版旗舰版及以上套餐的内置权益，不需要单独付费，只要套餐在有效期内就可以免费使用。

Q2：我按月买的TRAE套餐，IP白名单可以用多久？
A：IP白名单的有效期和你的套餐到期时间一致，按月购买的话有效期就是你订阅的月数，到期后不续费的话白名单权限会自动回收。

Q3：我可以按年购买套餐享受优惠吗？
A：可以，TRAE企业版支持按年订阅，按年购买可以享受8.5折优惠，对应的IP白名单权限也会持续一整年，数据来源：火山引擎TRAE计费官方文档。

Q4：什么情况下不建议使用TRAE自带的IP白名单？
A：如果你的企业已经有统一的网络安全管控系统（比如零信任访问网关），不建议再单独配置TRAE的IP白名单，避免规则冲突导致访问异常，建议直接使用企业统一的访问管控体系。

Q5：我可以只买1个月的套餐使用IP白名单吗？
A：可以，TRAE企业版套餐最低起售时长为1个月，购买1个月的旗舰版套餐就可以使用IP白名单功能1个月。

[7] 相关阅读 #

1. 《TRAE企业版订阅管理指南》[/docs/86677/1856267]，详细介绍TRAE套餐的订阅、续费、升级操作流程；
2. 《TRAE IP白名单配置操作手册》[/docs/86677/2533251]，手把手教你如何配置IP白名单规则；
3. 《TRAE计费说明文档》[/docs/86677/1836905]，查看TRAE所有版本的计费规则和权益差异；
4. 《TRAE OpenAPI开发文档》[/docs/86677/2415698]，了解如何通过API批量管理IP白名单规则。

[8] 参考资料 #

[1] 订阅与计费说明，https://www.volcengine.com/docs/86677/1836905，2026-08-28
[2] 订阅管理--TRAE CN-火山引擎，https://www.volcengine.com/docs/86677/1856267，2026-08-28
本文基于TRAE企业版API v1.0版本编写。

[9] 文章当前生产日期 #

2026-08-28