> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt
> Use this file to discover all available pages before exploring further.

使用 TRAE CN 企业版时，若发生网络问题，可参考以下思路进行排查。
## 检查对 TRAE 企业版域名的访问 {#9c428738}
根据你的操作系统，在终端中运行相关命令，检查你的网络是否可以正常访问 TRAE 的域名。

* macOS / Linux：
   ```Bash
   # TRAE 企业版的标准域名
   curl -sI https://console.enterprise.trae.cn | head -5
   
   # 如果有自定义域名，则替换为你的实际域名
   curl -sI https://xxx-cn-ent.trae.volces.com | head -5
   ```

* Windows PowerShell：
   ```Perl
   # TRAE 企业版的标准域名
   curl.exe -sI https://console.enterprise.trae.cn 2>$null | Select-Object -First 5
   
   # 如果有自定义域名，则替换为你的实际域名
   curl.exe -sI https://xxx-cn-ent.trae.volces.com 2>$null | Select-Object -First 5
   ```

* Windows CMD：
   ```Plain Text
   curl -sI https://console.enterprise.trae.cn
   ```


预期结果：
看到 `HTTP/2 200` 或 `HTTP/1.1 200` 开头的响应。如果超时或拒绝连接，说明网络不通，需联系你的企业的 IT 人员放行相关域名。
## 检查代理节点的连通性（若你的企业使用了网络代理） {#12ebc5ed}
部分企业配置了专有代理节点。代理地址可能是公网 IP（如 `101.126.54.80:3128`）或 PrivateLink 内网 IP（如 `xxx.xxx.xxx.xxx:3128`）。你可以通过以下步骤检查代理节点的连通性：

1. 在任意平台执行以下命令，验证代理节点是否可访问。
   ```Plain Text
   ping 101.126.54.80
   ```

   **预期结果**：能够收到来自目标 IP 的回显应答，表示当前环境与该节点之间的网络连通性正常。
   如果无法访问代理节点，按以下思路排查：
   * 公网 IP：检查目标主机的防火墙或安全组配置，是否允许 `ping` 请求。
   * PrivateLink：检查 VPC 对等连接是否建立；检查路由表配置是否正确。
2. 通过代理节点访问 TRAE 服务。
   * macOS / Linux：
      ```Bash
      # 公网 IP 示例（替换为实际代理 IP:端口）
      curl -x http://101.126.54.80:3128 https://gator.volces.com -v 2>&1 | head -20
      
      # PrivateLink 示例
      curl -x http://xxx.xxx.xxx.xxx:3128 https://gator.volces.com -v 2>&1 | head -20
      ```

   * Windows PowerShell：
      ```Perl
      curl.exe -x http://101.126.54.80:3128 https://gator.volces.com -v 2>&1 | Select-Object -First 20
      ```

      :::tip 提示
      在 PowerShell 中，`curl` 是 `Invoke-WebRequest` 的别名，必须使用 `curl.exe` 才能调用真正的 curl 命令。如果提示找不到 `curl.exe`，说明系统版本较老（Windows 10 1803 以下），可以改用 `Invoke-WebRequest -Uri "URL" -Method HEAD` 代替。
      :::
   * Windows CMD：
      ```Plain Text
      curl -x http://101.126.54.80:3128 https://gator.volces.com -v
      ```

   **预期结果**：如果能够通过代理节点与 TRAE 服务建立连接，并收到来自该服务的 HTTP 响应（即使返回 403/404），则说明当前环境经由该代理节点访问 TRAE 服务的网络链路是正常的。
   常见失败及含义：
   <!-- @cols-width: 231,324,286 -->
   | | | | \
   |**失败信息** |**可能原因** |**处理建议** |
   |---|---|---|
   | | | | \
   |Connection timed out |当前环境无法访问代理节点（如 IP 不可达或端口未开放）。 |* 检查代理节点的公网 IP/端口是否正确。 |\
   | | |* 确认目标主机的防火墙或安全组是否允许访问该端口。 |
   | | | | \
   |Connection refused |代理节点已可达，但对应端口上未运行服务。 |确认代理服务是否已启动，并监听在指定端口。 |
   | | | | \
   |Proxy CONNECT failed |代理节点无法与目标服务建立连接。 |检查代理节点的网络配置（如出网权限、路由、防火墙规则），确认其可以访问目标服务。 |
   | | | | \
   |DNS 解析失败 |当前 DNS 无法解析目标域名。 |检查本地 DNS 配置，或尝试使用其他 DNS 服务进行解析。 |


## 联系我们 {#a09da1ce}
若以上检查中未发现异常，发送邮件至 [feedback@mail.trae.ai](mailto:feedback@mail.trae.ai) 并提供日志。