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

本文介绍使用 TRAE 企业版客户端过程中，遇到网络问题时的处理方法。

## 通用排查思路 {#hxLOIDbbn}

### 检查对 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 服务进行解析。  |   


## TraeWork Design 模式生成的内容无法正常预览？ {#hrstQwV9x}

TraeWork Design 模式的设计系统与交互图由大模型生成，生成的 HTML 可能通过 `<script>` 或 `<link>` 引用公网 CDN 的 JavaScript、CSS 等资源。使用 Design 模式前，须确保 TraeWork 相关的公共域名已放行；否则部分内容可能无法预览、渲染或展示异常。需放行的公共域名列表参考[域名放行](/enterprise_access-control-for-trae-enterprise-exclusive-edition#hXX7ZGUOS)。

## 联系我们 {#a09da1ce}

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