Remote SSH 相关

本文档记录在使用 Remote SSH 时可能遇到的问题并提供解决方法。

错误码

错误码	错误内容	解决方案
1001	创建目录失败	检查磁盘剩余空间，确保有足够的空间用于创建目录。确保有 `~/.trae-cn-server` 目录的写入权限。
1002	创建目录失败	同 1001 错误码。
1003	远程主机上启动 TRAE CN 服务端失败	检查远程主机的系统版本是否满足要求。
2001	下载安装包失败	检查网络联通性，然后重试。
2002	解压安装包失败	可能是由于安装包的下载过程被截断，导致下载的文件异常，重新安装后再尝试解压。
3001	远程主机上启动 TRAE CN 服务端失败	检查远程主机的系统版本是否满足要求。

	连接超时原因	解决方案
	服务器未启动，或网络无法连接	若连接失败：检查远程主机的 TRAE CN 服务端是否正常运行。确认网络连接无异常。若连接成功：继续排查其他潜在问题。
	远程主机名称包含大写字母	升级客户端：将 TRAE CN 客户端更新至最新版本。修改主机名：将配置文件中的主机名称全部改为小写字母。
	不支持服务器的默认 shell	目前，一些 shell 会导致连接异常，比如 fish。将用户的默认 shell 改成 bash 和 zsh 以解决该问题。
	本地 `~/.ssh/config` 文件位置变动	如果挪动过本地的 `~/.ssh/config` 文件的位置，可能会遇到这个问题。将 `~/.ssh/config` 文件放回原先的位置以解决该问题。

若以上解决方案仍无法解决你的问题，可以通过《支持》中提供的渠道联系我们。请在问题反馈中提供以下信息，以便我们尽快定位问题并协助你解决:

如果 AI 报告 997 错误，这通常表示你的服务器存在网络连接问题。

执行以下命令，确认你的服务器是否能成功连接到 TRAE CN 的服务：

curl -vvv “https://trae.cn”

如果以上 curl 命令在执行时报错，请先解决网络问题。

在 Linux 上，可能会由于 GLIBC 问题导致进程无法启动。

问题现象

根本原因

TRAE CN Server 为了保证在老旧系统上的兼容性，自带了一个较旧版本的 libstdc++.so``.6。

当系统环境中有程序（或被强制注入的库）由新版编译器编译，并依赖新版 GLIBCXX 符号时，TRAE CN 自带的旧库无法满足需求，从而导致加载失败。

解决方案

在 Linux 服务器上执行以下命令，检查是否存在 libstdc++ 版本冲突。
grep -r “version `GLIBCXX_.*’ not found” ~/.trae-cn-server/manager-logs/
如果命令输出类似以下内容，说明确实存在 libstdc++ 版本冲突，继续完成以下步骤来解决该冲突。
…/libstdc++.so.6: version `GLIBCXX_3.4.30′ not found (required by /etc/thunder/libthunder.so)
找到 TRAE CN Server 的安装目录。
提示该目录通常在 ~/.trae-cn-server/bin/stable-<commit-id>-debian10/ 下。你也可以从报错日志中提取准确的路径。
重命名自带的 libstdc++.so``.6：
进入 lib/trae-helper 目录（或报错日志中指示的包含 libstdc++.so``.6 的目录）。
重命名自带的库文件。
示例路径，请根据实际的路径调整cd ~/.trae-cn-server/bin/stable-*-debian10/lib/trae-helper/# 备份并重命名自带的库文件，迫使程序使用系统的 libstdc++.so.6mv libstdc++.so.6 libstdc++.so.6.bak
重启服务：
完全退出本地的 TRAE CN。
重启 TRAE CN。
尝试重新连接远程服务器。