使用 SSH 进行远程开发

远程资源管理功能（Remote SSH）提供了在本地 PC 上直接访问和操作远程主机文件的能力。通过这一功能，你无需在本地 PC 上存储远程主机上的源代码，即可充分利用 TraeCode 的全部功能（包括代码补全、导航、调试、AI 辅助等）来管理远程主机上的文件。

具体而言，当你通过 TraeCode 连接本地 PC 与远程主机时，系统会自动在远程主机的操作系统上安装 TraeCode 服务端。TraeCode 服务端与远程主机上已存在的 TraeCode 客户端相互独立，包含了所有必要的后台服务，确保提供与本地开发环境一致的使用体验。

前置条件

• 确保你的开发环境满足以下要求：

  设备类型	要求
  本地 PC	确保安装了 OpenSSH 兼容的 SSH 客户端，操作系统可为 macOS 或 Windows。
  远程主机	目前，仅支持 Linux 操作系统，建议的系统版本和配置如下： 操作系统： Debian 格式：Debian 10+、Ubuntu 20.04+ RPM 格式：Fedora 42、RHEL 9.x 系统配置：至少 1 GB RAM，更推荐 2 GB 和 2-core CPU 的组合 处理器：x64、ARM64 提示：低于要求的操作系统版本（如 Debian 8、Ubuntu 16 等）将导致你无法使用 AI 功能，包括 Inline Chat、Side Chat、代码自动补全、AI 生成 Git Commit 消息等，同时也可能与其它功能存在兼容性问题。

• 确保远程服务器已安装并运行 SSH 服务器。
• 为了确保 TRAE 服务端的正常运行，远程主机需要具备出站 HTTPS 访问能力（通过端口 443）。这一连接主要用于 TRAE 服务端与外部端点的通信，用于更新服务和拓展支持。
• 某些扩展可能有额外的连接性要求。

连接远程主机

在本地 PC 上连接远程主机后，你可以在本地 PC 上为远程主机上的文件开发内容。

1. 打开远程资源管理器，然后点击 + 按钮。
   
   界面上显示 输入 SSH 连接命令 面板。
   
2. 输入 SSH 连接命令，然后按下回车键。
   远程主机已添加，界面右下方出现提示框，SSH 连接目标 列表中出现远程主机地址。
   
3. 在右下方的提示框中，点击 连接主机 按钮；或在 SSH 连接目标 列表中，将鼠标悬浮至目标主机地址，然后点击右侧的 在新窗口连接主机 图标。
   界面上显示密码输入框。
   
4. 输入密码，然后按下回车键。

   提示

   • 建议使用基于密钥的认证以提高安全性。
   • 密码不会被保存，每次连接时都需要重新输入。
   TraeCode 开始连接远程主机。连接成功后，界面左下角显示已连接的主机地址。
   
5. 打开远程主机中的文件夹，开始远程开发。

断开与远程主机的连接

• 直接退出 TraeCode，下次打开后会优先提示你完成远程连接。
• 在顶部菜单栏中，选择 文件 > 关闭远程连接。
  

配置或删除连接主机

点击远程资源管理器中的 修改远程连接配置 图标，然后在 config 文件中配置或删除远程主机。

快捷操作面板说明

使用 Alt + Ctrl + O 快捷键可打开 Remote SSH 快捷操作面板。你可以在面板上直接发起连接主机、打开远程连接配置文件等操作。

更多功能

管理插件

插件可分别在本地 PC 和远程主机中运行：

• 本地运行插件：提供用户界面相关的插件通常在本地运行。
• 远程主机插件：语言支持、调试工具等插件则在远程主机运行。

在插件市场的 已安装 列表中，你可以查看本地 PC 和远程主机中安装的插件，然后按需管理它们。

打开远程主机的终端

在顶部菜单栏中，选择 终端 > 新建终端，打开在远程主机上运行的终端，然后执行命令。

转发远程端口至本地 PC

TraeCode 支持将远程主机的端口转发到本地 PC，你可以在终端中配置。

远程调试

连接到远程主机后，可以使用 TraeCode 的调试功能，与本地调试类似。在 launch.json 文件中选择启动配置并按 F5 键开始调试，应用程序将在远程主机上启动，调试器会附加到其中。