Reomote-ssh 用户手册： 使用 SSH 开发（Remote SSH） - 文档 - TRAE CN
WSL 用户手册： 使用 WSL 开发 - 文档 - TRAE CN
=========
问题排查指导
“三板斧”万能解决办法
可以先按照以下方式进行初步处理：
-
在终端内输入“ps -eaf |grep index_trae” ，然后把 index_trae 相关进程找出来，都 kill 掉
-
执行以下命令
# 中国版本
rm -rf ~/.trae-cn-server/bin
# 海外版本
rm -rf ~/.trae-server/bin
- 然后再尝试重连
不同错误码对应的解决方案
| 错误码 | 错误内容 | 解决方案 |
|---|---|---|
| 1003 | 远程主机上启动 Trae CN 服务端失败 | 检查远程主机的系统版本是否满足要求。 |
| 3001 | 远程主机上启动 Trae CN 服务端失败 | 检查远程主机的系统版本是否满足要求。 |
| 2002 | 解压安装包失败 | 可能是由于安装包的下载过程被截断，导致下载的文件异常，重新安装后再尝试解压。 |
| 1001 | 创建目录失败 | 可能是因为磁盘空间不足或无目录的写入权限。解决方案如下： - 检查磁盘剩余空间，确保有足够的空间用于创建目录。 - 确保有 ~/.trae-cn-server 目录的写入权限。 |
| 1002 | 创建目录失败 | 同 1001 错误码。 |
| 2001 | 下载安装包失败 | 检查网络连通性，然后重试。 |
连接超时
| 连接超时原因 | 解决方案 |
|---|---|
| 服务器未启动，或网络无法连接 | 在本地终端执行 ssh 测试远程连接： - 若连接失败： - 检查远程主机的 Trae CN 服务端是否正常运行。 - 确认网络连接无异常。 - 若连接成功：继续排查其他潜在问题。 |
| 远程主机名称包含大写字母 | 部分 Trae CN 客户端版本存在兼容性问题：当 ~/.ssh/config 文件中远程主机名称包含大写字母时，可能导致连接超时。解决方案如下： - 升级客户端：将 Trae CN 客户端更新至最新版本。 - 修改主机名：将配置文件中的主机名称全部改为小写字母。 |
| 不支持服务器的默认 shell | 目前，一些 shell 会导致连接异常，比如 fish。将用户的默认 shell 改成 bash 和 zsh 以解决该问题。 |
| 本地 ~/.ssh/config 文件位置变动 | 如果挪动过本地的 ~/.ssh/config 文件的位置，可能会遇到这个问题。将 ~/.ssh/config 文件放回原先的位置以解决该问题。 |
若以上解决方案仍无法解决你的问题，请在本版块发帖寻求技术支持帮助。
尽可能提供提供以下信息，以便我们尽快定位问题并协助你解决:
-
IDE 截图（尽量截取完整的 IDE 界面图，以便我们分辨异常信息）。
-
日志（从输出面板复制 Remote-SSH 相关的完整日志）。
- 如果是连接超时问题，附上 ssh -vvv 命令的完整输出结果，我们会根据此信息定位超时的原因。
ssh -vvv test
# 此处会输出大量日志，请复制完整的日志
常见问题 FAQs
远程环境下，新开控制台，默认旧语言环境，必须在当前terminal手动切换，如何处理？
可以按照以下方式进行处理：
- 打开远程窗口的「setting.json」，添加下方的配置，完全关闭远程再打开
{ "terminal.integrated.profiles.linux": { "zsh (login)": { "path": "zsh", "args": ["-l"] } }, "terminal.integrated.defaultProfile.linux": "zsh (login)" }
重启后 Terminal 消失
可以查看启动日志「~/.trae-cn-server/.stable-xxxxx.log」，可能因为文件损坏，删除后重新安装即可。
是否支持Dev Container？
由于一些技术实现的原因，我们暂时还不支持，具体支持时间欢迎留意官方通知。
远程连接报错“1006”
可以先按照以下方式进行初步处理：
-
在终端内输入“ps -eaf |grep index_trae” ，然后把 index_trae 相关进程找出来，都 kill 掉
-
执行以下命令
# 中国版本
rm -rf ~/.trae-cn-server/bin
# 海外版本
rm -rf ~/.trae-server/bin
- 然后再尝试重连
远程连接报错“2001”
可能的原因是远程连接的机器没有在外网环境、或者区域检测失败，可以先检查下机子是否具有公网的网络
Debian 9开发机服务无法启动，且连接不稳定
Debian 9已不再受支持，自VSCode 1.99版本起，也禁止与之连接。若确实需要使用，可尝试使用VSCode 1.98版本搭配Trae AI插件，以此至少能够进行 AI chat。
无法通过TRAE SSH连接到服务器，但终端和VSCode均可连接
请先确认用的是什么版本，然后执行对应的命令
直接通过SSH登录到服务器，执行以下命令，然后重新尝试连接：
# 中国版本
rm -rf ~/.trae-cn-server/bin
# 海外版本
rm -rf ~/.trae-server/bin
采用 fish shell 时远程连接失败
若当前默认 shell 为 fish，确实无法建立远程连接，可尝试将默认 shell 更改为 bash。此问题在 VSCode 中同样存在，属于共性问题，目前尚未解决。
无法连接到远程扩展主机服务器（错误：exitCode：1001，unknown error）
对于错误代码1001，首先检查机器的磁盘空间是否充足，通常此类问题是由磁盘空间不足或文件夹权限异常等原因导致的。
通过Trae Remote SSH连接到开发机，在终端输入文本时响应卡顿
进行相关配置。
网络超时和代理配置相关的问题
可尝试勾选此配置：remote.SSH.enhancedCompatibilityMode，然后重新进行远程连接。
WSL 远程连接后提示“插件安装失败”
去VSCode 插件市场找到对应插件的 vsix 文件，手动安装到 wsl 里即可。