使用 SSH 进行远程开发
基于 SSH 的远程开发功能使您能够直接使用本地 PC 访问和管理远程主机上的文件。
通过此功能，您可以充分利用 Trae 的所有功能，包括代码补全、导航、调试和 AI 助手，来管理远程文件，而无需将远程主机的源代码存储在本地 PC 上。
具体来说，当您通过 Trae 将本地 PC 连接到远程主机时，系统会自动在远程主机的操作系统上安装 Trae 服务器。Trae 服务器独立于远程主机上现有的 Trae 客户端运行，并包含所有必要的后台服务，确保与本地开发环境匹配的一致开发体验。
架构
SSH 远程开发设置遵循以下架构：
- 本地 PC：运行带有 UI 扩展的 Trae 客户端
- 远程主机：运行带有工作区扩展、AI 后端、源代码、终端和调试器的 Trae 服务器
- 连接：本地 PC 和远程主机之间的安全 SSH 隧道
先决条件
确保您的系统满足以下要求：
本地 PC 要求
- 确保安装了兼容 OpenSSH 的 SSH 客户端
- 操作系统可以是 macOS 或 Windows
远程主机要求
目前仅支持 Linux 操作系统。推荐的系统版本和配置为：
- 操作系统（发行版）：Debian 10+、Ubuntu 20.04+
- 系统配置：至少 1 GB RAM，最好是 2 GB 和 2 核 CPU 的组合
- 处理器：x64
重要说明：
- 低于所需版本的操作系统（如 Debian 8、Ubuntu 16 等）将阻止您使用 AI 功能，包括内联聊天、侧边聊天、构建器模式、自动补全和 AI 生成的 Git 提交消息。其他功能也可能存在兼容性问题。如果您遇到此类问题，请随时向 feedback@email.trae.ai 提供反馈。
- 其他供应商的发行版（如 CentOS 和 RHEL）和操作系统（如 Windows 和 macOS）将在未来逐步支持。如需额外支持，请联系 feedback@email.trae.ai。
其他要求
- 确保远程服务器已安装并运行 SSH 服务器
- 为确保 Trae 服务器正常运行，远程主机必须具有出站 HTTPS 访问权限（通过端口 443）。此连接主要用于 Trae 服务器与外部端点之间的通信，以进行服务更新和扩展支持
- 某些扩展可能对更好的连接性有额外要求
连接到远程主机
从本地 PC 连接到远程主机后，您可以直接从本地 PC 开发远程主机上的文件内容。
步骤 1：添加远程主机
- 打开远程资源管理器并点击 + 按钮
- 出现输入 SSH 连接命令面板
- 填写 SSH 连接命令并按 Enter 键
- 远程主机已添加。右下角出现相关提示，远程主机地址出现在 SSH 目标列表中
步骤 2：连接到主机
- 在右下角的提示中，点击连接按钮；或将光标悬停在 SSH 目标列表中的主机地址上，点击右侧的在新窗口中连接到主机图标
- 出现密码输入面板
- 填写密码并按 Enter 键
注意：建议使用基于密钥的身份验证来增强安全性。密码不会保存在 Trae 中，每次连接到远程主机时都需要重新输入。
步骤 3：开始开发
- Trae 开始连接到远程主机。连接后，远程主机地址出现在左下角
- 打开远程主机上存在的文件夹，在本地 PC 上开始远程开发
断开与远程主机的连接
您可以通过两种方式断开与远程主机的连接：
- 直接退出 Trae：下次打开时，系统会提示您首先完成远程连接
- 使用菜单：在顶部菜单栏中，选择文件 > 关闭远程连接
设置或删除已连接的远程主机
在远程资源管理器中点击配置图标，然后在配置文件中配置或删除远程主机。
快速访问面板
您可以使用快捷键 Alt + Ctrl + O 打开远程 SSH 快速访问面板。在此面板上，您可以启动连接到远程主机、打开 SSH 配置文件等任务。
其他功能
管理远程主机的扩展
扩展可以在本地 PC 和远程主机上分别运行：
- 本地扩展：提供用户界面相关功能的扩展通常在本地 PC 上运行
- 远程扩展：用于语言支持、调试工具和类似功能的扩展在远程主机上运行
在扩展商店中，您可以查看本地 PC 和远程主机的已安装扩展列表，然后根据需要管理它们。
在远程主机上打开终端
从顶部菜单栏中，选择终端 > 新建终端以打开在远程主机上运行的终端，然后执行您的命令。
在远程主机上调试
连接到远程主机后，您可以使用 Trae 的调试功能，这与本地调试类似。您需要在 launch.json 文件中选择启动配置并按 F5 开始调试。应用程序将在远程主机上启动，调试器将附加到它。