在企业网络环境中,公司通常会通过代理服务器统一管理访问外部服务的出站流量。
如果当前网络环境需要通过代理访问外部服务,你可以在 TRAE 企业版客户端中配置网络代理,支持使用系统网络代理或手动配置代理。配置后,TRAE 客户端的网络请求可按企业要求通过指定代理转发,便于公司进行访问控制、安全检测和审计管理。
套餐要求
旗舰版。
适用客户端
生效范围与规则
- TRAE 客户端中的网络代理为个人配置。配置后,仅对当前登录的 TRAE 账号生效,不会在企业内全局生效。
- 对于 TRAE IDE,若成员在客户端中选择 “系统” 或 “手动” 代理模式,该个人配置将优先于管理员在火山引擎 TRAE 控制台中的企业级网络代理配置生效。
前置条件
- 若使用系统网络代理,确保当前设备的操作系统中已配置网络代理,且代理服务处于可用状态。
- 若手动配置网络代理,确保已获取代理服务器的协议、地址和端口,并确认地址和端口可访问。
- (仅 TRAE IDE) 若使用云端网络代理,确保企业管理员已在火山引擎 TRAE 控制台中配置并启用企业级网络代理。详细步骤参考此文档。
操作步骤
- 登录 TRAE IDE 或 TRAE Work 桌面版。
- 前往 设置 > 通用。
- 在 网络 > 网络代理 区域,根据你的网络环境选择代理配置方式。

可配置的代理模式如下:
- 使用系统网络代理
将代理模式设置为 系统。TRAE Work 桌面版会使用当前设备操作系统中的网络代理配置。 - 手动配置网络代理
- 将代理模式设置为 手动。
- 在 代理地址 处,输入代理服务器地址。
提示
地址需包含协议和端口。TRAE Work 桌面版支持 HTTP 和 HTTPS 代理,例如 http://127.0.0.1:9000 或 https://proxy.example.com:8443。
- (可选) 在 代理例外 处,输入不需要通过网络代理访问的域名或 IP 地址。多个地址可使用英文逗号分隔,例如
127.0.0.1,example.com。 - (可选) 点击 测试连接 按钮,测试当前配置是否生效。
- 若测试成功,仅表示当前代理配置验证通过,不代表代理服务或网络环境持续可用。代理服务及网络连通性需由用户自行确认。
- 若测试失败,检查代理协议、地址、端口、代理服务状态,以及当前设备是否已连接所需的企业网络或 VPN。
- 使用云端网络代理(仅 TRAE IDE)
将代理模式设置为 云端。
该模式用于兼容企业已开通的网络代理方案。启用后,TRAE IDE 将使用企业管理员在火山引擎 TRAE 控制台中配置的网络代理,无需在客户端手动填写代理地址。提示
企业管理员在火山引擎 TRAE 控制台中完成代理配置后,配置会自动下发至所有成员的 TRAE IDE 客户端。若客户端此前未切换为 “系统” 或 “手动” 代理模式,将默认使用 “云端” 代理配置,无需再次手动选择。