配置网络代理后，TRAE 客户端的网络请求将通过指定代理转发，适用于有网络访问管控的企业环境。

套餐要求

旗舰版。

适用客户端

TraeCode

TraeCode Plugin

TraeCode CLI

配置公网代理

若企业允许 TRAE 客户端请求通过公网代理转发，可按以下步骤配置公网代理。

第一步：将指定 IP 地址和域名添加至白名单

联系企业的 IT 部门，将以下公网代理 IP 地址和 TRAE 访问域名添加至企业防火墙的白名单。

公网代理 IP 地址：101.126.54.80:3128

TRAE 访问域名：

若企业已在 TRAE 中开通专属域名，则需将专属域名添加至白名单。

若企业未配置专属域名，则需将 https://console.enterprise.trae.cn 添加至白名单。

第二步：测试公网代理的连通性

验证办公网络是否可以通过公网代理访问 TRAE 服务。

测试公网代理节点能否 ping 通

# 公网代理 IP 地址示例
ping 101.126.54.80

预期结果：能收到回复。如果无法 ping 通，请检查本地网络策略和防火墙配置。

测试能否通过公网代理访问 TRAE 服务

macOS/Linux
Windows PowerShell
Windows CMD

# 公网代理 IP 地址示例（替换为实际代理的 IP:端口）
curl -x http://101.126.54.80:3128 https://gator.volces.com -v 2>&1 | head -20

预期结果：能够建立连接并收到 HTTP 响应。即使返回的状态码为 403 或 404，也表明网络连接正常。

第三步：开通公网代理

前往火山引擎上的 TRAE 控制台。

在左侧导航栏中，选择访问控制。

你将进入访问控制配置管理页面。

在网络代理服务处，打开网络代理开关。

页面上出现开通网络代理弹窗。

在 IP 地址字段处，填入公网代理的 IP 地址：101.126.54.80:3128。

点击确定按钮。

公网代理配置完成。

第四步：重新登录

更新 TRAE 客户端至支持网络代理的版本，并重新登录，使公网代理生效。

配置私网代理

若企业仅允许 TRAE 客户端的请求通过私网代理转发，可按以下步骤配置私网代理。

第一步：创建私网终端节点

前往火山引擎上的 TRAE 控制台。

在左侧导航栏中，选择访问控制。

你将进入访问控制配置管理页面。

在专属域名访问处，选择私网设置页签。

在创建私有网络终端节点卡片处，点击右上角的去创建终端节点按钮。

你将进入创建终端节点面板。

参考下表中的要求，配置终端节点相关字段。

类别	字段	配置要求
基本信息	地域	选择华北2（北京）。
		名称	可自由填写，为更好地与其他终端节点区分，建议填写 trae-endpoint。
		类型	选择接口。
		描述（可选）	填写该终端节点服务的描述信息。
		所属项目	选择该终端节点的所属项目，便于统一管理资源。
终端节点服务	添加方式	选择通过服务名称添加。
终端节点服务		终端节点服务	添加 com.volces.privatelink.cn-beijing.epsvc-1my9zt535pybk1qigxq64qa9r 服务，然后点击验证。
网络配置	IP 地址类型	已自动设置为 IPv4，不支持修改。
		私有网络	选择一个私有网络。若你还未创建私有网络，需先点击右侧的创建私有网络进行创建。详情参考此文档。提示：私有网络的可用区必须为 “可用区A”、“可用区B” 和 “可用区C” 中的一个。
		可用区及子网	选择可用区及子网。在创建私有网络时，你可以同步创建子网。若未创建，需先点击右侧的创建子网进行创建。详情参考此文档。提示：子网的可用区必须为 “可用区A”、“可用区B” 和 “可用区C” 中的一个。
		安全组	选择安全组。若未创建安全组，需先点击右侧的创建安全组进行创建。详情参考此文档。
高级选项	私有 DNS 名称	选择不启用。

在右侧的配置详情面板中，确认你的配置，阅读并同意相关协议，然后点击立即购买按钮。

私有网络终端节点已创建。

返回私网设置页签，检查私有网络的可用状态。

若 “实例状态” 为 “可用”，“链接状态” 为 “已连接”，则表示私有网络可正常使用。

第二步：确保该终端节点在私网内可访问

企业需自行确保上一步创建的私网终端节点可从办公网络或目标私网环境访问。

获取私网终端节点所连接的可用区的 IP 地址，步骤如下：

前往火山引擎中的私有网络管理中心。

在左侧导航栏中，选择私网连接 > 终端节点。

在接口终端节点页签中，找到服务名称包含 epsvc-1my9zt535pybk1qigxq64qa9r 的终端节点，确认其 “连接状态” 为 “已连接”。

点击该终端节点的名称，进入其详情页。

切换至可用区与网卡页签。

记录 IP 地址列中的 IP 地址。该地址即为终端节点所连接的可用区的 IP 地址。

在私网中测试该终端节点，代理端口为 3128，即代理的 IP 地址格式为 xxx.xxx.xxx.xxx:3128。

第三步：测试私网代理的连通性

验证办公网络是否可以通过私网终端节点代理访问 TRAE 服务。

测试私网终端节点能否 ping 通

ping {私网终端节点的 IP 地址}

预期结果：能收到回复。如果无法 ping 通，请检查 VPC 对等连接和路由表。

测试能否通过私网终端节点访问 TRAE 服务

macOS/Linux
Windows PowerShell
Windows CMD

# PrivateLink 代理的 IP 地址示例（需替换为实际代理的 IP:端口）
curl -x http://xxx.xxx.xxx.xxx:3128 https://gator.volces.com -v 2>&1 | head -20

预期结果：能够建立连接并收到 HTTP 响应。即使返回的状态码为 403 或 404，也表明网络连接正常。

注意事项：通过代理访问 HTTPS 服务时，客户端或系统可能会访问 CA 域名，以完成证书链下载以及 OCSP/CRL 吊销状态校验。以下域名均为 CA 官方域名，仅用于证书校验，不承载 TRAE 业务数据。若企业网络对出站域名有限制，可根据实际管控策略选择以下任一方式加白：

精确域名加白：cdp.rapidssl.com、status.rapidssl.com、cacerts.rapidssl.com、ocsp.digicert.com、crl3.digicert.com、crl4.digicert.com、cacerts.digicert.com、secure.globalsign.com、ocsp.globalsign.com、www.globalsign.com

通配符域名加白：*.rapidssl.com、*.digicert.com、.globalsign.com

第四步：开通私网代理

回到访问控制配置管理页面。

在网络代理服务处，打开网络代理开关。

页面上出现开通网络代理弹窗。

在 IP 地址字段处，填入私网代理的 IP 地址，即 xxx.xxx.xxx.xxx:3128。

点击确定按钮。

私网代理配置完成。

第五步：重新登录

更新 TRAE 客户端至支持网络代理的版本，并重新登录，使私网代理生效。

常见问题

私网终端节点的详情页无 “可用区” 页签或弹性网卡 IP

确认终端节点的类型为 “接口”（非 “网关”）。只有 “接口” 类型的终端节点才会分配弹性网卡 IP。

curl 验证失败

检查安全组规则是否已放行该 IP 地址的 TCP 3128 端口，并确认企业私网可以成功访问该 IP 地址。

TRAE CN