网络问题

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

通用排查思路

检查对 TRAE 企业版域名的访问

根据你的操作系统，在终端中运行相关命令，检查你的网络是否可以正常访问 TRAE 的域名。

macOS / Linux：

# TRAE 企业版的标准域名
curl -sI https://console.enterprise.trae.cn | head -5 

# 如果有自定义域名，则替换为你的实际域名
curl -sI https://xxx-cn-ent.trae.volces.com | head -5

Windows PowerShell：

# 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：

curl -sI https://console.enterprise.trae.cn

预期结果：

看到 HTTP/2 200 或 HTTP/1.1 200 开头的响应。如果超时或拒绝连接，说明网络不通，需联系你的企业的 IT 人员放行相关域名。

检查代理节点的连通性（若你的企业使用了网络代理）

部分企业配置了专有代理节点。代理地址可能是公网 IP（如 101.126.54.80:3128）或 PrivateLink 内网 IP（如 xxx.xxx.xxx.xxx:3128）。你可以通过以下步骤检查代理节点的连通性：

在任意平台执行以下命令，验证代理节点是否可访问。
```
ping 101.126.54.80
```
预期结果：能够收到来自目标 IP 的回显应答，表示当前环境与该节点之间的网络连通性正常。
如果无法访问代理节点，按以下思路排查：
- 公网 IP：检查目标主机的防火墙或安全组配置，是否允许 ping 请求。
- PrivateLink：检查 VPC 对等连接是否建立；检查路由表配置是否正确。

通过代理节点访问 TRAE 服务。

macOS / Linux：

# 公网 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：
```
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：

curl -x http://101.126.54.80:3128 https://gator.volces.com -v

预期结果：如果能够通过代理节点与 TRAE 服务建立连接，并收到来自该服务的 HTTP 响应（即使返回 403/404），则说明当前环境经由该代理节点访问 TRAE 服务的网络链路是正常的。
常见失败及含义：

失败信息	可能原因	处理建议
Connection timed out	当前环境无法访问代理节点（如 IP 不可达或端口未开放）。	检查代理节点的公网 IP/端口是否正确。确认目标主机的防火墙或安全组是否允许访问该端口。
Connection refused	代理节点已可达，但对应端口上未运行服务。	确认代理服务是否已启动，并监听在指定端口。
Proxy CONNECT failed	代理节点无法与目标服务建立连接。	检查代理节点的网络配置（如出网权限、路由、防火墙规则），确认其可以访问目标服务。
DNS 解析失败	当前 DNS 无法解析目标域名。	检查本地 DNS 配置，或尝试使用其他 DNS 服务进行解析。

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

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

联系我们

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

文档对您有帮助吗?