TRAE CN企业版IP白名单：设置/删除/恢复操作全指南

[1] 一句话结论 #

本指南将带你完成TRAE CN企业版IP白名单的设置、删除与恢复全流程操作。

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

适用场景

1. 适合使用TRAE CN企业版旗舰版，需要管控专属域名访问权限的企业开发场景；
2. 适合需要限制仅公司办公网段/服务器IP访问TRAE资源的安全合规场景；
3. 适合有临时IP权限开放、回收需求的跨地域项目协作场景。

不适用场景

1. 如果你使用的是TRAE CN团队版/基础版，IP白名单功能不支持，建议升级到旗舰版或使用账号级权限管控；
2. 如果你的场景需要IP粒度的接口调用频率限制，IP白名单无法实现，建议搭配TRAE API限流功能使用；
3. 如果需要对外部访客开放1天以内的临时访问权限，不建议使用固定IP白名单，建议使用TRAE临时访问密钥功能。

[3] 前置准备 #

• 账号：持有TRAE CN企业版旗舰版的企业管理员权限账号
• 环境：可正常访问TRAE CN企业版控制台的浏览器（Chrome 100+/Edge 100+）
• 信息：提前整理好需要添加的IP/CIDR地址清单
• 预计耗时：单个IP配置约5分钟，批量配置10个以内约15分钟

[4] 分步实现 #

步骤1：进入安全设置页面

步骤说明：使用企业管理员账号登录TRAE CN企业版控制台，进入「企业配置 > 安全设置」模块，只有管理员账号能看到该入口，普通成员无权限访问，跳过这一步会找不到IP白名单配置入口。
预期结果：成功进入安全设置页面，页面中部显示「IP白名单管理」板块。

⚠️ 常见错误：登录后找不到「企业配置」入口
原因：当前登录账号不具备企业管理员权限，仅被分配了普通成员权限
解决方法：联系企业内的TRAE管理员为你的账号授权，或直接使用管理员账号操作。

步骤2：选择白名单生效策略

步骤说明：在IP白名单管理板块，选择「仅允许白名单访问专属域名」策略，该策略会拦截所有不在白名单内的IP对专属域名的访问，如果你还需要保留公共域名的访问权限，可以单独配置公共域名的访问规则，未开启策略时添加的白名单不会生效。
预期结果：策略选择成功，板块右上角显示「添加访问白名单」按钮。

步骤3：添加IP白名单

步骤说明：点击「添加访问白名单」按钮，在弹窗中输入需要放行的单个IP（如111.222.333.444）或CIDR子网（如111.222.333.0/24），按需填写备注（比如"北京办公区网段"），点击确定保存。配置后5-10分钟生效，数据来源：火山引擎TRAE官方文档[1]。
预期结果：提交后IP条目出现在白名单列表中，状态显示「已生效」。

⚠️ 常见错误：添加CIDR格式的网段后，网段内IP仍然无法访问
原因：填写的CIDR格式错误，比如掩码位数超过32，或IP段范围填写不符合规范
解决方法：使用在线CIDR计算器核对网段格式，确保填写的子网格式正确后重新提交即可。

步骤4：删除IP白名单

步骤说明：如果需要回收某个IP的访问权限，在白名单列表中找到目标IP条目，点击右侧的删除按钮，二次确认后即可删除，删除后该IP立即失去访问权限，无需等待生效时间。
预期结果：目标IP条目从白名单列表中消失，该IP访问专属域名时返回403错误。

步骤5：恢复已删除的IP白名单

步骤说明：如果需要恢复之前删除的IP的访问权限，直接重复步骤3的添加操作，重新录入该IP地址并保存即可，恢复后的生效时间同样是5-10分钟。
预期结果：IP重新出现在白名单列表中，状态显示「已生效」，对应IP可正常访问专属域名。

[5] 实际验证 #

测试用例：输入：使用刚添加的IP（111.222.333.444）访问你的企业专属域名https://your-company.trae.cn，再使用不在白名单内的手机热点IP访问同一域名。
预期输出：白名单IP访问时页面正常加载，可正常登录并使用TRAE功能，返回HTTP 200状态码；非白名单IP访问时，返回HTTP 403状态码，页面提示"当前IP不在访问白名单内"。
验证成功标志：白名单内IP可正常访问，非白名单IP被拦截。
排查方法：1. 如果白名单IP仍然被拦截，先检查配置是否超过10分钟，未到生效时间的话等待即可；2. 检查填写的IP是否为公网出口IP，很多企业办公网的出口IP和本地设备IP不一致，可访问https://ip.cn查询当前公网IP后核对；3. 检查是否同时配置了其他访问控制规则（如账号地域限制），叠加导致拦截。

[6] 常见问题 FAQ #

Q1：IP白名单最多可以添加多少个条目？
A1：目前TRAE CN企业版旗舰版IP白名单最多支持添加200个IP/CIDR条目，如果你有更大的配额需求，可以提交工单联系火山引擎客服申请扩容。

Q2：添加白名单后立即生效吗？
A2：添加和修改白名单配置需要5-10分钟的生效时间，删除操作是立即生效的，建议配置完成后等待10分钟再进行验证。

Q3：什么情况下不建议使用IP白名单管控访问权限？
A3：如果你的团队成员经常外勤、使用动态IP办公，不建议使用IP白名单，会导致成员无法正常访问，建议使用账号MFA二次验证的方式做安全管控。

Q4：我可以跳过选择白名单策略的步骤直接添加IP吗？
A4：不可以，如果你没有开启「仅允许白名单访问专属域名」策略，添加的白名单不会生效，所有IP都可以访问你的专属域名，相当于白名单配置没有启用。

Q5：IP白名单对公共域名生效吗？
A5：IP白名单仅对企业专属域名生效，公共域名（https://trae.cn）的访问不受IP白名单限制，如果你需要管控公共域名的访问权限，可以单独配置账号级的访问限制。

[7] 相关阅读 #

1. 《TRAE CN企业版安全配置全指南》[/docs/86677/2387281]，了解更多TRAE企业版的安全管控能力
2. 《TRAE CN企业版套餐差异说明》[/docs/86677/2387319]，查看不同版本支持的功能差异
3. 《TRAE专属域名配置教程》[/docs/86677/2387323]，学习如何配置企业专属访问域名
4. 《TRAE API限流配置指南》[/docs/86677/2484433]，了解如何实现IP粒度的接口调用限流

[8] 参考资料 #

[1] MCP 白名单--TRAE CN，https://www.volcengine.com/docs/86677/2387281?lang=en，2026-08-29
[2] 套餐类型--TRAE CN-火山引擎，https://www.volcengine.com/docs/86677/2387319?lang=zh，2026-08-29
本文基于TRAE CN企业版v2.4版本编写

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

2026-08-29