TRAE CN企业版白名单设置：4步完成公网访问控制

[1] 一句话结论 #

本指南将带你完成TRAE CN企业版公网访问白名单的全流程配置。

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

适用场景

1. 已开通TRAE CN企业版，需要限制仅公司办公IP可访问平台的研发团队场景；
2. 日均平台访问人次超过50，有等保2.0三级等数据安全合规要求的企业场景；
3. 已配置专属域名，需要避免非授权人员访问登录入口的高安全需求场景。

不适用场景

1. 个人版/专业版TRAE用户：当前访问控制白名单仅企业版支持，建议升级到企业版或使用账号二次认证方案；
2. 外勤/出差人员频繁访问场景：如果团队经常需要异地访问TRAE，不建议使用公网白名单，建议搭配单点登录权限控制方案；
3. 内网专线接入场景：如果企业已经通过专线内网接入TRAE，建议直接配置内网防火墙规则，无需使用公网白名单功能。

[3] 前置准备 #

• 已开通TRAE CN企业版账号，拥有企业超级管理员/安全管理员权限；
• 已整理好需要放行的公网IP/IP段列表（支持CIDR格式）；
• 浏览器版本要求Chrome 100+/Edge 100+，避免控制台操作异常；
• 预计配置总耗时15-20分钟（含专属域名生效等待时间）。

[4] 分步实现 #

步骤1：进入访问控制配置页面

步骤说明：我们首先要登录TRAE企业版控制台，进入安全配置入口，这一步是所有配置的基础，跳过的话无法找到白名单配置入口。
操作路径：登录TRAE企业版控制台，依次点击「企业配置 > 安全设置 > 访问控制」，点击「管理访问控制」按钮跳转至火山引擎TRAE访问控制页面。
预期结果：成功进入访问控制配置页，页面展示「专属域名访问」、「公网设置」等配置模块。

⚠️ 常见错误：点击「管理访问控制」后提示“无权限访问该页面”
原因：当前登录账号不是企业管理员，只有企业超级管理员/安全管理员角色才有访问控制配置权限。
解决方法：联系企业内部TRAE管理员分配对应角色权限，或直接使用管理员账号登录操作。

步骤2：启用专属域名

步骤说明：公网白名单功能仅在绑定专属域名后可用，启用自定义专属域名可以避免和公共域名的访问策略冲突，跳过这一步无法开启白名单策略。
操作：在专属域名访问区域点击「立即启用」，输入自定义域名前缀（比如yourcompany-trae）后提交确认。
预期结果：页面提示“专属域名配置中，预计5-10分钟生效”，可刷新页面查看生效状态。

步骤3：选择访问控制策略

步骤说明：配置完专属域名后，我们需要选择访问控制的模式，这里必须选择仅白名单访问才能开启IP限制功能，如果选默认的全公网访问，后续添加的白名单不会生效。
操作：切换到专属域名访问下的「公网设置」页签，选择「仅允许白名单访问专属域名」选项并保存。
预期结果：页面顶部弹出“策略修改成功”的提示。

⚠️ 常见错误：选择白名单策略后，所有用户都无法访问平台
原因：还没有添加任何IP到白名单就切换了策略，导致所有IP都被拦截。
解决方法：使用绑定的管理员手机号接收验证码，临时解锁访问权限，先添加管理员当前出口IP到白名单后再切换策略。

步骤4：添加IP白名单

步骤说明：把需要放行的IP地址/IP段添加到白名单中，添加后只有这些IP可以访问专属域名的登录页面，未在白名单的IP仅能访问域名但无法完成登录操作。
操作：点击「添加访问白名单」按钮，在弹窗中填入IP地址（支持CIDR格式，比如192.168.1.0/24），填写备注（比如“北京朝阳办公区出口IP”）后点击确定。
预期结果：白名单列表中出现刚才添加的IP条目，状态显示为“已生效”。

[5] 实际验证 #

测试用例：

1. 负向测试：使用不在白名单中的手机流量访问专属域名，预期返回“当前IP不在访问白名单中，无法访问”提示；
2. 正向测试：使用已添加到白名单的办公网络访问专属域名，正常加载登录页面。

验证成功标志：HTTP状态码返回200，登录页面正常加载，且可以正常输入账号密码完成登录进入TRAE工作台。

验证失败常见排查方法：

1. IP添加错误：访问ip138.com查询当前出口公网IP，确认和白名单中填写的IP一致，若不一致重新添加正确IP即可；
2. 域名未生效：等待10分钟后刷新页面，或执行ipconfig /flushdns（Windows）/sudo dscacheutil -flushcache（Mac）清除浏览器DNS缓存后重试；
3. 策略未生效：返回公网设置页签，确认已经勾选「仅允许白名单访问专属域名」选项且保存成功。

[6] 常见问题 FAQ #

Q1：白名单最多可以添加多少个IP？
A：目前单个企业版账号最多支持添加100个IP/IP段，该数据来自火山引擎官方文档，如果需要更多配额可以提交工单申请扩容，最高可支持到1000个条目。

Q2：白名单配置后多久生效？
A：正常情况下添加完成后1分钟内生效，如果遇到网络延迟最多不超过5分钟，可刷新白名单列表查看状态确认是否生效。

Q3：什么情况下不建议使用白名单功能？
A：如果你的团队成员经常需要在外勤、出差场景下访问TRAE，不建议使用公网白名单，会导致异地访问受限，建议搭配单点登录和设备权限管控来保障安全。

Q4：可以同时配置公网白名单和内网访问吗？
A：可以，白名单仅对公网访问生效，内网专线接入的访问不受公网白名单限制，内网访问需要单独配置企业内网防火墙规则。

Q5：删除白名单IP后，之前登录的用户还能继续使用吗？
A：删除后用户的登录会话会在1小时内过期，需要重新登录，此时IP不在白名单中就无法继续访问平台。

[7] 相关阅读 #

1. 《TRAE CN企业版专属域名配置指南》，[/docs/86677/2387323]，讲解专属域名的自定义配置和自定义SSL证书绑定方法；
2. 《TRAE CN企业版单点登录配置教程》，[/blog/trae-sso-config]，教你如何配置SAML2.0单点登录，进一步提升账号访问安全性；
3. 《TRAE CN企业版命令黑名单配置指南》，[/docs/86677/2387281]，讲解如何限制沙箱中高危命令执行，避免安全风险。

[8] 参考资料 #

[1] TRAE CN 企业版访问控制官方文档，https://docs.volcengine.com/docs/86677/2387323?lang=zh，2026年8月29日
[2] TRAE CN 企业版白名单配置实践指南，https://docs.trae.cn/enterprise_access-control-for-trae-enterprise-exclusive-edition，2026年8月29日
本文基于TRAE CN企业版v2.4.0版本编写

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

2026-08-29