trae remote-ssh仅支持linux（debian 10+/ubuntu 20.04+），不兼容windows/macos/旧版linux；需校验本地ssh配置无主机名前缀、远程ssh服务启用、apparmor模块加载、/tmp可执行，且通过trace日志定位失败阶段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在 Trae AI IDE 中启用远程 SSH 开发功能，但连接失败或无法加载远程文件系统，则可能是由于目标服务器操作系统不兼容、本地 SSH 配置错误或远程服务端部署条件缺失。以下是验证与适配此问题的具体步骤：
一、确认远程主机操作系统为受支持的 Linux 发行版
Trae 的 Remote-SSH 功能依赖 Bash 环境执行平台探测脚本及服务端自动部署，其底层逻辑硬编码调用 Linux Shell 语法，仅兼容内核为 Linux 且发行版为 Debian 10+ 或 Ubuntu 20.04+ 的系统。Windows（含 WSL2）、macOS（Darwin 内核）及旧版 Linux 均会触发 Error platform not supported: $KERNEL 类错误并立即断连。
1、访问 Trae 官方文档“使用 SSH 开发”章节，核对当前版本明确列出的支持系统列表。
2、通过其他终端工具（如 PuTTY 或系统终端）登录目标远程主机，执行命令：cat /etc/os-release，检查输出中是否包含 ID=debian 且 VERSION_ID="11"（或更高），或 ID=ubuntu 且 VERSION_ID="22.04"（或更高）。
3、若输出中出现 ID="windows"、ID="msys"、ID="cygwin"、ID="darwin" 或 PRETTY_NAME="AlmaLinux" 等非官方支持标识，则该主机不可用于 Trae Remote-SSH 连接。
二、校验本地 SSH 配置文件语法与字段规范
Trae 依赖本地 OpenSSH 客户端发起连接流程，若 ~/.ssh/config（Linux/macOS）或 c:\Users\{用户名}\.ssh\config（Windows）中存在格式错误、非法字符或协议不兼容字段，将导致连接在认证前终止，表现为 Connection refused 或日志为空。
1、使用文本编辑器打开本地 SSH 配置文件，定位到对应 Host 区块。
2、检查 User 字段是否包含 Windows 主机名前缀（例如 DESKTOP-CMPLRVG\QuniteZone），该格式违反 SSH 协议规范，必须删除前缀仅保留纯用户名（如 QuniteZone）。
3、确认 HostName 为可解析的 IP 地址或域名，且 Port 值为整数（默认 22），不得含空格或引号。
4、保存配置后，在终端执行：ssh -T -F ~/.ssh/config -o ConnectTimeout=5 QuniteZone@162.14.108.122（替换为实际用户名与地址），验证基础连通性与配置有效性。
三、确保远程主机已启用 SSH 服务并开放必要内核模块
Trae 在密码/密钥认证成功后，会尝试部署服务端组件并检测 AppArmor 等安全模块状态。若远程主机未启用 SSH 服务、禁用 root 登录、缺少 lsmod 或 apparmor_status 工具，或内核未加载 AppArmor 模块，将触发静默断连，日志中可见 Error platform not supported: $KERNEL 输出。
1、在远程主机上执行：sudo systemctl is-active ssh，返回 active 表示服务运行正常；若为 inactive，则执行 sudo systemctl start ssh 启动。
2、执行：lsmod | grep apparmor，若无任何输出，说明 AppArmor 未加载；此时需执行：sudo modprobe apparmor 并确认 /sys/module/apparmor 目录存在。
3、检查远程主机是否安装基础工具链：which bash lsmod cat grep sudo，任一命令返回空值均需通过 apt install -y bash procps（Debian/Ubuntu）补全。
四、手动验证 Trae 服务端部署脚本执行权限
Trae 连接成功后会在远程主机 /tmp/trae-remote-ssh-* 目录下释放部署脚本，并以当前用户权限执行。若远程用户主目录所在文件系统挂载时设置了 noexec 标志，或 /tmp 被挂载为 nosuid,nodev,noexec，将导致脚本无法运行，连接中断。
1、登录远程主机，执行：mount | grep "$(df . | tail -1 | awk '{print $1}')" | grep noexec，若输出含 noexec，则需修改挂载选项或切换工作目录。
2、执行：df -T /tmp，确认 /tmp 所在分区类型为 ext4 或 xfs，而非 tmpfs（部分云主机默认启用 tmpfs 且设 noexec）。
3、临时绕过限制：执行 export TMPDIR="$HOME/tmp" && mkdir -p "$TMPDIR"，再重新发起 Trae 连接，促使服务端脚本写入用户可执行目录。
五、启用 Trae 客户端调试日志以定位具体失败阶段
Trae 默认隐藏底层 SSH 日志，仅显示简略提示。开启详细日志可明确区分失败发生在认证前、认证后、还是服务端部署阶段，避免盲目排查。
1、在 Trae 中按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并选择 Remote-SSH: Toggle Log Level。
2、将日志级别设为 Trace，然后再次尝试连接目标主机。
3、连接失败后，在 Trae 底部状态栏点击 Remote Explorer 图标旁的 [Log] 链接，查看完整输出；重点搜索关键词：Authentication succeeded（认证成功）、Executing script on remote（脚本执行）、platform not supported（平台不支持）。
