Trae Remote Optimizer(Trae 远程开发环境优化)
针对 Trae Remote-SSH 远程开发(AI 在本地推理、服务器执行代码)场景,优化 SSH 连接稳定性、文件同步效率与服务器开发资源。
环境自动判定(先执行,决定走哪个分支)
按以下顺序判定优化目标,只读、快速,不要过度探查:
- 用户明说目标:说"服务器/远程机"→ 服务器分支;"本机/电脑/Trae/VS Code/客户端"→ 客户端分支;"都优化/都要"→ 两个分支都走。
- 未明说时,检测当前机器是否为 Trae 客户端:若 OS 是 Windows,且存在 Trae/VS Code 配置目录(
%APPDATA%\Trae CN、%APPDATA%\Trae、%APPDATA%\Code之一)和~/.ssh/config→ 判定当前就是客户端,走客户端分支。 - 目标是远程服务器:若用户提供 SSH 目标(别名/IP)且经登录验证为 Linux、存在
/etc/ssh/sshd_config→ 判定为服务器,走服务器分支。
判定结论明确后,再读对应参考文档执行;不要预先加载两个分支的细节。
客户端分支(本机 Trae / VS Code,Windows)
目标机器是运行 Trae/VS Code 的本地电脑。优化点:
1. ~/.ssh/config:统一密钥 + 保活 + 关闭无关耗时项 + 安全默认。
2. Trae/VS Code settings.json:remote.SSH.* 重连/稳定性项 + files.watcherExclude 排除大目录。
必须遵守:Windows 上不要启用 ControlMaster(会报 getsockname failed 且连接失败)。改配置前先备份。
→ 完整操作见 references/client.md
服务器分支(Linux / sshd)
目标是通过 SSH 访问的 Linux 服务器。优化点:sshd 保活提速、inotify 文件监控上限、Swap 防编译 OOM、nofile 上限。
首选一键脚本:上传并执行 scripts/remote-dev-tune-server.sh(scp 对中文别名会解析失败,用 IP + -P 端口)。脚本自动备份、先校验后重启、输出每步结果。
→ 完整操作与回滚见 references/server.md
执行通则
- 先备份后修改:config、settings.json、sshd_config 修改前均备份,标注时间戳。
- 保留既有配置:合并而非覆盖用户已有的条目。
- 严格校验:settings.json 用 Python 严格 JSON 校验;sshd 用
sshd -t校验后再重启;关键项用ssh -G/sshd -T实测确认生效。 - 验证通过才算完成:改动后必须用真实命令回读确认(连接、生效项、swap、inotify)。
- 可回滚:每项改动都要能单独撤销(见各 reference 的回滚小节)。
- 谨慎约束:不主动扩大范围(如未要求不改防火墙、不装软件、不重启无关服务);修改 sshd 属有影响操作,先向用户说明影响。
- 多服务器批量:客户端 SSH config 配好一次,多台服务器只需在 config 各加一段;服务器用同一脚本逐台上传执行即可。
- sshd 安全提示:改 sshd_config 前,确保当前密钥已能登录(改错会锁死远程);执行前确认
sshd -t通过,并保留备份可回滚。