问题排查/网络问题
网络问题
更新于: 2026-06-11 19:19:28
使用 TRAE CN 企业版时,若发生网络问题,可参考以下思路进行排查。
根据你的操作系统,在终端中运行相关命令,检查你的网络是否可以正常访问 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 的回显应答,表示当前环境与该节点之间的网络连通性正常。
如果无法访问代理节点,按以下思路排查:
ping 请求。通过代理节点访问 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 不可达或端口未开放)。 |
|
|
Connection refused |
代理节点已可达,但对应端口上未运行服务。 |
确认代理服务是否已启动,并监听在指定端口。 |
|
Proxy CONNECT failed |
代理节点无法与目标服务建立连接。 |
检查代理节点的网络配置(如出网权限、路由、防火墙规则),确认其可以访问目标服务。 |
|
DNS 解析失败 |
当前 DNS 无法解析目标域名。 |
检查本地 DNS 配置,或尝试使用其他 DNS 服务进行解析。 |
若以上检查中未发现异常,发送邮件至 feedback@mail.trae.ai 并提供日志。