配置网络代理后，TRAE 客户端的网络请求将通过指定代理转发，适用于有网络访问管控的企业环境。 ## 套餐要求旗舰版。 ## 适用客户端 * TRAE IDE * TRAE 插件 * TRAE CLI ## 配置公网代理若企业允许 TRAE 客户端请求通过公网代理转发，可按以下步骤配置公网代理。 ### 第一步：将指定 IP 地址和域名添加至白名单联系企业的 IT 部门，将以下公网代理 IP 地址和 TRAE 访问域名添加至企业防火墙的白名单。 * **公网代理 IP 地址**：`101.126.54.80:3128` * **TRAE 访问域名**： * 若企业已在 TRAE 中开通专属域名，则需将专属域名添加至白名单。 * 若企业未配置专属域名，则需将 `https://console.enterprise.trae.cn` 添加至白名单。 ### 第二步：**测试公网代理的连通性** 验证办公网络是否可以通过公网代理访问 TRAE 服务。 1. **测试公网代理节点能否 ping 通** ```Bash # 公网代理 IP 地址示例 ping 101.126.54.80 ``` **预期结果**：能收到回复。如果无法 ping 通，请检查本地网络策略和防火墙配置。 2. **测试能否通过公网代理访问 TRAE 服务** macOS/Linux ```Bash # 公网代理 IP 地址示例（替换为实际代理的 IP:端口） curl -x http://101.126.54.80:3128 https://gator.volces.com -v 2>&1 | head -20 ``` Windows PowerShell ```PowerShell # 公网代理 IP 地址示例（替换为实际代理的 IP:端口） curl.exe -x http://101.126.54.80:3128 https://gator.volces.com -v 2>&1 | Select-Object -First 20 ``` 在 PowerShell 中 `curl` 是 `Invoke-WebRequest` 的别名，必须使用 `curl.exe` 才能调用真正的 curl 命令。如果提示找不到 `curl.exe`，说明系统版本较老（Windows 10 1803 以下），可以改用 `Invoke-WebRequest -Uri "URL" -Method HEAD` 代替。 Windows CMD ```Bash # 公网代理 IP 地址示例（替换为实际代理的 IP:端口） curl -x http://101.126.54.80:3128 https://gator.volces.com -v ``` **预期结果**：能够建立连接并收到 HTTP 响应。即使返回的状态码为 `403` 或 `404`，也表明网络连接正常。 ### 第三步：开通公网代理 1. 前往[火山引擎上的 TRAE 控制台](https://console.volcengine.com/trae/)。 2. 在左侧导航栏中，选择 **访问控制**。你将进入访问控制配置管理页面。 3. 在 **网络代理服务** 处，打开 **网络代理** 开关。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/496e3cac664c4850bed86e1142ffb829) 页面上出现 **开通网络代理** 弹窗。 4. 在 **IP 地址** 字段处，填入公网代理的 IP 地址：`101.126.54.80:3128`。 5. 点击 **确定** 按钮。公网代理配置完成。 ### 第四步：重新登录更新 TRAE 客户端至支持网络代理的版本，并重新登录，使公网代理生效。 ## 配置私网代理若企业仅允许 TRAE 客户端的请求通过私网代理转发，可按以下步骤配置私网代理。 ### 第一步：创建私网终端节点 1. 前往[火山引擎上的 TRAE 控制台](https://console.volcengine.com/trae/)。 2. 在左侧导航栏中，选择 **访问控制**。你将进入访问控制配置管理页面。 3. 在 **专属域名访问** 处，选择 **私网设置** 页签。 4. 在 **创建私有网络终端节点 ** 卡片处，点击右上角的 **去创建终端节点** 按钮。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/c335fc12525c404a966b72c37144bbf0) 你将进入 **创建终端节点** 面板。 5. 参考下表中的要求，配置终端节点相关字段。 |**类别** |**字段** |**配置要求** | |---|---|---| |基本信息 |地域 |选择 **华北2（北京）** 。 | ||名称 |可自由填写，为更好地与其他终端节点区分，建议填写 **trae\-endpoint**。 | ||类型 |选择 **接口**。 | ||描述（可选） |填写该终端节点服务的描述信息。 | ||所属项目 |选择该终端节点的所属项目，便于统一管理资源。 | |终端节点服务 |添加方式 |选择 **通过服务名称添加**。 | ||终端节点服务 |添加 `com.volces.privatelink.cn-beijing.epsvc-1my9zt535pybk1qigxq64qa9r` 服务，然后点击 **验证**。 | |网络配置 |IP 地址类型 |已自动设置为 **IPv4**，不支持修改。 | ||私有网络 |选择一个私有网络。

若你还未创建私有网络，需先点击右侧的 **创建私有网络** 进行创建。详情参考[此文档](https://www.volcengine.com/docs/6401/69467?lang=zh)。

***提示***：私有网络的可用区必须为 “可用区A”、“可用区B” 和 “可用区C” 中的一个。 | ||可用区及子网 |选择可用区及子网。

在创建私有网络时，你可以同步创建子网。若未创建，需先点击右侧的 **创建子网** 进行创建。详情参考[此文档](https://www.volcengine.com/docs/6401/67823?lang=zh)。

***提示***：子网的可用区必须为 “可用区A”、“可用区B” 和 “可用区C” 中的一个。 | ||安全组 |选择安全组。

若未创建安全组，需先点击右侧的 **创建安全组** 进行创建。详情参考[此文档](https://www.volcengine.com/docs/6401/68894?lang=zh)。 | |高级选项 |私有 DNS 名称 |选择 **不启用**。 | 6. 在右侧的 **配置详情** 面板中，确认你的配置，阅读并同意相关协议，然后点击 **立即购买** 按钮。私有网络终端节点已创建。 7. 返回 **私网设置** 页签，检查私有网络的可用状态。若 “实例状态” 为 “可用”，“链接状态” 为 “已连接”，则表示私有网络可正常使用。 ### 第二步：**确保该终端节点在私网内可访问** 企业需自行确保上一步创建的私网终端节点可从办公网络或目标私网环境访问。 1. 获取私网终端节点所连接的可用区的 IP 地址，步骤如下： 1. 前往火山引擎中的私有网络管理中心。 2. 在左侧导航栏中，选择 **私网连接** \> **终端节点**。 3. 在 **接口终端节点** 页签中，找到服务名称包含 `epsvc-1my9zt535pybk1qigxq64qa9r` 的终端节点，确认其 “连接状态” 为 “已连接”。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/dc88062ae7fc455ba7858a978da23167) 4. 点击该终端节点的名称，进入其详情页。 5. 切换至 **可用区与网卡** 页签。 6. 记录 ** IP 地址** 列中的 IP 地址。该地址即为终端节点所连接的可用区的 IP 地址。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/adf6ba4a3af04a129452ce4bc42f1520)

提示

如配置了多个可用区，每个可用区各有一个弹性网卡 IP 地址，选择企业私网内可正常访问的 IP 地址即可。该 IP 地址固定分配，不会变化。

2. 在私网中测试该终端节点，代理端口为 `3128`，即代理的 IP 地址格式为 `xxx.xxx.xxx.xxx:3128`。 ### 第三步：**测试私网代理的连通性** 验证办公网络是否可以通过私网终端节点代理访问 TRAE 服务。 * **测试私网终端节点能否 ping 通** ```Bash ping {私网终端节点的 IP 地址} ``` **预期结果**：能收到回复。如果无法 ping 通，请检查 VPC 对等连接和路由表。 * **测试能否通过私网终端节点访问 TRAE 服务** macOS/Linux ```Bash # PrivateLink 代理的 IP 地址示例（需替换为实际代理的 IP:端口） curl -x http://xxx.xxx.xxx.xxx:3128 https://gator.volces.com -v 2>&1 | head -20 ``` Windows PowerShell ```PowerShell # PrivateLink 代理的 IP 地址示例（需替换为实际代理的 IP:端口） curl.exe -x http://xxx.xxx.xxx.xxx:3128 https://gator.volces.com -v 2>&1 | Select-Object -First 20 ``` 在 PowerShell 中 `curl` 是 `Invoke-WebRequest` 的别名，必须使用 `curl.exe` 才能调用真正的 curl 命令。如果提示找不到 `curl.exe`，说明系统版本较老（Windows 10 1803 以下），可以改用 `Invoke-WebRequest -Uri "URL" -Method HEAD` 代替。 Windows CMD ```Bash # PrivateLink 代理的 IP 地址示例（需替换为实际代理的 IP:端口） curl -x http://xxx.xxx.xxx.xxx:3128 https://gator.volces.com -v ``` **预期结果**：能够建立连接并收到 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` ### 第四步：开通私网代理 1. 回到访问控制配置管理页面。 2. 在 **网络代理服务** 处，打开 **网络代理** 开关。 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/496e3cac664c4850bed86e1142ffb829) 页面上出现 **开通网络代理** 弹窗。 3. 在 **IP 地址** 字段处，填入私网代理的 IP 地址，即 `xxx.xxx.xxx.xxx:3128`。 4. 点击 **确定** 按钮。私网代理配置完成。 ### 第五步：重新登录更新 TRAE 客户端至支持网络代理的版本，并重新登录，使私网代理生效。 ## 常见问题 * **私网终端节点的详情页无 “可用区” 页签或弹性网卡 IP** 确认终端节点的类型为 “接口”（非 “网关”）。只有 “接口” 类型的终端节点才会分配弹性网卡 IP。 * **`curl`** ** 验证失败** 检查安全组规则是否已放行该 IP 地址的 TCP `3128` 端口，并确认企业私网可以成功访问该 IP 地址。

TRAE CN