# 在远程项目中工作

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

远程项目在   JetBrains 客户端   中打开，就像在您本地的 IntelliJ IDEA IDE 中打开一样。 您可以像开发其他本地项目一样开发它：编辑代码、运行应用程序、调试和部署。

![远程项目](https://resources.jetbrains.com/help/img/idea/2026.3/remote_project.png)

如果您想了解更多关于 Remote Development 流程和架构的内容，请参阅 [远程开发概述](remote-development-overview.html)。

Procedure: 向已打开的项目添加 SDK

当您第一次打开项目时，IntelliJ IDEA 会显示一个通知，建议添加项目 SDK。

1. 打开远程会话。

2. 在主菜单中，前往  `文件 | 项目结构` 。

3. 在   项目结构  对话框中，选择   项目  ，并从可用选项中配置项目的 SDK。

4. 请点击   OK   以保存更改。 IntelliJ IDEA 将已配置的 SDK 下载到远程服务器。 下次您打开项目时，下载的 SDK 将在远程会话中自动使用。

Procedure: 添加 VM 选项

您可以调整远程项目的 VM 选项，特别是如果您希望在处理较大的项目时增加  `-Xmx`  内存大小。 您需要执行这些操作并在远程服务器上保存您的更改。

1. 在主菜单中，前往  `帮助 | 编辑自定义 VM 选项（在主机上）` 。

2. 请编辑  `idea64.vmoptions` 文件。

例如，将  `-Xmx2048`  选项更改为  `-Xmx3072` 。

有关 VM 选项的更多信息，请参阅 [高级配置](tuning-the-ide.html)。

3. 请在远程服务器上重启您的 IDE 以查看更改。

4. 如果您的远程项目无法正常启动，您可以 [手动增加内存设置](remote-development-troubleshooting.html#remote_work)。

Procedure: 在远程后端登录 GitHub

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `版本控制 | GitHub` 。

2. 点击   添加账户  ，选择授权方法并登录到您的 GitHub 帐户。

![GitHub 设置](https://resources.jetbrains.com/help/img/idea/2026.3/sign_in_to_github_on_host.png)

Procedure: 关闭远程开发会话

* 点击 ![关闭按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.windows.closeActive.svg) 关闭远程会话窗口。

您将返回到   JetBrains Gateway  欢迎屏幕，您可以使用 [最近的 SSH 项目](remote-development-a.html#rd_recent_projects)页面重新连接到您的远程会话或停止正在运行的实例。

> **Note:**
> 当您在本地关闭项目时，它不会在远程主机上自动关闭。

Procedure: 创建多个连接

您可以创建多个连接到同一个远程主机和同一个版本的 IDE。 您还可以与不同版本的 IDE 和远程主机建立连接。

1. 连接并开启远程会话。

2. 由于 您 连接到远程服务器后 JetBrains Gateway 会始终处于活动状态，您可以点击它的图标来打开   JetBrains Gateway  欢迎屏幕并配置其他连接。

如果您连接到相同的   IDE 版本  ，那么   JetBrains 客户端   将作为相同进程的实例打开。 如果您连接到不同的远程主机或   IDE 版本  ，将启动一个不同的远程会话。

> **Note:**
> 您无法从不同的计算机连接到同一个服务器。 例如，如果您与团队共享远程服务器并希望在同一个项目上工作，要么等到服务器空闲，要么向连接方请求 [Code With Me link](code-with-me.html)以加入远程会话。

## 安装插件

您可以为远程项目安装所需的插件。

根据您在远程服务器上下载 IntelliJ IDEA 的场景，您可以通过命令行安装插件，也可以使用远程项目的 UI 进行安装。

安装插件后，在 [插件设置](plugins-settings.html) 的描述页面上会出现一个指示器，用于显示插件的安装位置：在远程主机、在 JetBrains 客户端，或同时在二者上。

![插件设置对话框](https://resources.jetbrains.com/help/img/idea/2026.3/settings_remote_plugins.png)

请注意，插件是按项目安装的。 每次为新项目创建远程连接时，您都需要安装所需的插件。

> **Note:**
> 如果在尝试安装插件时遇到问题，请向我们的 [支持团队](https://www.jetbrains.com/zh-cn/support/)提交问题。

Procedure: 通过命令行安装插件

如果您在远程服务器上 [手动配置](remote-development-a.html#use_idea) IntelliJ IDEA，请按照以下步骤添加插件：

1. 在 [JetBrains Marketplace](https://plugins.jetbrains.com/) 中，找到要安装的插件页面，向下滚动到   附加信息   部分，并复制   插件 ID   形参的值，例如  `org.jetbrains.plugins.github` 。

2. 打开远程服务器，进入您的项目所在且您希望下载和安装第三方插件的 IntelliJ IDEA 实例。

默认情况下，下载的 IntelliJ IDEA 实例位于以下目录：

```SHELL
~/.cache/JetBrains/RemoteDev/dist

```

3. 请添加以下命令：

```SHELL
bin/remote-dev-server.sh installPlugins PROJECT_PATH pluginId

```

（其中  `PROJECT_PATH` 是您远程项目的路径，  `pluginId` 是您从 [JetBrains Marketplace](https://plugins.jetbrains.com/)页面获得的ID。）

> **Note:**
> 如果后端启动时带有未启用的第三方插件，该插件将被禁用，并且日志中会出现一条消息，建议用户使用  `--give-consent-to-use-third-party-plugins`  选项并搭配  `installPlugins` 。

安装后，解压下载的插件存档。

默认情况下，已安装的插件会被放置在后端的以下文件夹中：

```SHELL
~/.local/shared/JetBrains/<ide name><ide version>

```

4. 继续 [启动 JetBrains Gateway](remote-development-a.html#use_local_ide) 并使用远程安装的插件打开远程项目。

Procedure: 通过 UI 安装插件

如果您 [使用 JetBrains Gateway](remote-development-a.html#launch_gateway)将 IntelliJ IDEA 下载到远程服务器，请按照以下步骤安装插件。

1. 在   JetBrains 客户端   中打开远程项目。

2. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

3. [安装](managing-plugins.html#install_plugin_from_repo) 所需插件，其方式与常规 IntelliJ IDEA 项目相同。

![插件设置对话框](https://resources.jetbrains.com/help/img/idea/2026.3/plugins_remote.png)

关于常规插件安装的更多信息，请参阅 [插件](managing-plugins.html)。

4. 在下载并启用插件后，点击   OK  以保存更改。

插件已远程安装。 但是，请注意，该插件是按项目安装的。

> **Note:**
> 当您在启动 JetBrains Gateway 之前使用  `gateway installPlugins *idPlugin*`  命令安装插件时，第三方插件不会在 JetBrains Gateway 启动时自动下载。 相反，会收到一条消息，提示接受安装第三方插件。
>
>
>
> 要绕过此消息并在 Gateway 启动时安装必要的第三方插件，请使用以下命令：
>
> `gateway installPlugins *idPlugin* --give-consent-to-use-third-party-plugins`

## 上传和下载文件

您可以在本地文件系统和远程后端之间下载和上传文件。

可以使用 `Ctrl+C` (Windows), `⌘ C` (macOS), `⌘ C` (IntelliJ IDEA Classic (macOS)), `⌘ C` (macOS System Shortcuts), `Ctrl+C` (XWin), `Ctrl+C` (GNOME), `Ctrl+C` (KDE), `Ctrl+Insert` (Emacs), `Ctrl+C` (Sublime Text), `⌘ C` (Sublime Text (macOS)), `Ctrl+C` (Visual Studio), `⌘ C` (Visual Studio (macOS)), `Ctrl+C` (NetBeans), `Ctrl+C` (Eclipse), `⌘ C` (Eclipse (macOS))/ `Ctrl+V` (Windows), `⌘ V` (macOS), `⌘ V` (IntelliJ IDEA Classic (macOS)), `⌘ V` (macOS System Shortcuts), `Ctrl+V` (XWin), `Ctrl+V` (GNOME), `Ctrl+V` (KDE), `Shift+Insert` (Emacs), `Ctrl+Shift+V` (Sublime Text), `⌘ ⇧ V` (Sublime Text (macOS)), `Ctrl+V` (Visual Studio), `⌘ V` (Visual Studio (macOS)), `Ctrl+V` (NetBeans), `Ctrl+V` (Eclipse), `⌘ V` (Eclipse (macOS)) 和拖放操作将文件从本地文件系统传输到打开的远程项目。

要从远程后端下载文件到本地文件系统，请按照以下步骤操作：

Procedure: 从远程后端下载文件到本地计算机

1. 在打开的远程   项目   工具窗口中，右键点击要下载的文件。

2. 在上下文菜单中，选择   下载文件到本地计算机  。

或者，使用拖放操作。

3. 在打开的对话框中，选择要将文件下载到的目录，然后点击   OK  。

## 后端控制中心

当您使用远程项目时，您可以检查远程服务器的状态。 这意味着您可以检查 后端 的 CPU 负载、磁盘 和 内存消耗。 您还可以直接在 JetBrains 客户端中增加堆大小并重启远程后端。

您还可以查看项目中转发的端口列表。

打开远程项目后，后台名称、内存和延迟指示器将显示在主工具栏上。

![主工具栏](https://resources.jetbrains.com/help/img/idea/2026.3/backend_toolbar.png)

Procedure: 使用控制中心窗口

1. 在 JetBrains Client 中，点击主工具栏上远程服务器的名称，以打开后端控制窗口。

![后端状态详情](https://resources.jetbrains.com/help/img/idea/2026.3/connection_details.png)

![后端状态详情](https://resources.jetbrains.com/help/img/idea/2026.3/ws_connection_details.png)

2. 在   性能   选项卡上，检查 CPU 负载、内存消耗和磁盘 Space 的状态。失敗しました、再試行してください。

* Ping 测试 ：这是一个时间指示器，显示使用 RD 协议在 JetBrains Client 和远程服务器之间传输数据所需的时间。

* CPU 负载 ：这是 CPU 执行的进程数的指示器。

* 内存 (RAM) ：这是一个显示远程服务器 RAM 状态的指示器。 如果达到内存限制，您需要访问您的远程服务器并增加内存或终止占用内存的进程。

* 磁盘 ：这是远程服务器使用了多少磁盘空间的指示。

3. 点击   端口  选项卡查看状态、数量和 [转发端口](security-model.html#port_forwarding)名称。

4. 点击   输出  选项卡查看来自远程服务器的日志文件的最后 2500 个符号。

此信息能帮助您查看日志文件的结尾以及可能发生的错误或问题。

![输出选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/control_center_output.png)

5. 如果您想增加堆内存大小，请点击   设置  选项卡，并在   最大堆大小  字段中添加所需的内存量，然后点击   保存并重启  以应用更改。 或者，如果您不希望立即重启后端，可以点击   保存  。

![设置选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/control_center_settings.png)

如果在 JetBrains 客户端中工作时遇到问题，您可以打开后端 IDE 的主工具窗口，并尝试在那里解决问题。

Procedure: 访问后端 IDE 界面

1. 在 JetBrains Client 中，点击主工具栏上的远程服务器名称以打开   后端  控制窗口。

2. 在打开的窗口中，点击 ![更多选项](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.moreHorizontal.svg) 并选择   显示主窗口  。

> **Tip:**
> 您可以通过选择   收集主机和客户端日志  选项来收集数据并创建日志文件。

![显示主工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/show_main_window.png)

后台 IDE 的主窗口被投影。 现在，您可以使用它来访问远程设置并配置各种远程选项，如果您无法在 JetBrains Client 中做到这一点。

> **Note:**
> 请注意，远程服务器是 Linux，所以您用于配置远程设置的快捷键必须是 Linux 的。

## 在远程后端管理凭证存储机制

您可以配置如何在远程服务器上管理密码，并重写默认配置。

默认情况下，KeePass 管理器用于在后端存储密码信息，正如您在 [后端密码设置](#password_settings)中所看到的那样。

您可以创建一个文件来存储有关可用身份验证存储机制和默认身份验证存储机制的信息，并用它重写系统提供的机制。

例如，  `KEEPASS`  机制将所有内容保存在硬盘上，这是一个小小的缺点。 但是，如果您希望在 IDE 重启之间保存凭据（数据库凭据、GitHub tokens 等），则应选择  `KEEPASS`  机制。

另一方面，  `IN_MEMORY` 机制让您可以将所有内容保存在正在运行的 IDE 的内存中，并在重新启动 IDE 时清除所有内容。 所有内容都不会保存在硬盘上，这样更安全。

Procedure: 为所有后端设置存储凭证存储机制的文件

1. 创建  `CredentialStore` 目录和以下  `settingName` 文件：

* `defaultProvider` ：用于默认的密码存储机制。 文件将包含以下一个值（ `MEMORY_ONLY` 、 `KEYCHAIN` 、 `KEEPASS` ）

* `availableProviders` ：可用的密码存储机制。 该文件将包含来自（ `MEMORY_ONLY` 、 `KEYCHAIN` 、 `KEEPASS` ）的逗号分隔值

您可以在本地操作系统上创建文件并将其复制到远程服务器，或者直接在远程服务器上创建这些文件。

2. 将创建的文件添加到远程服务器。 如果您在本地系统上创建了这些文件，则可以在终端中使用以下命令将文件复制到远程服务器上的所需位置：

```SHELL
scp source/filename [username]@[host]: destination

```

远程后端文件的位置如下：

* `$HOME/.config/JetBrains/CredentialStore/settingName` （适用于用户特定设置）

* `/etc/xdg/JetBrains/CredentialStore/settingName` （适用于系统范围设置）

![远程文件系统](https://resources.jetbrains.com/help/img/idea/2026.3/remote_file_system.png)

3. 在您将文件添加到远程服务器后， [password settings](#password_settings)只会显示默认和可用的密码存储提供程序。

![远程密码设置](https://resources.jetbrains.com/help/img/idea/2026.3/remote_password_settings_fixed.png)

如果要重写默认设置，可以将  `availableProviders`  和  `defaultProvider`  密钥添加到文件中。

例如，如果要使用  `KEEPASS`  机制来存储密码，可以将以下密钥添加到  `availableProviders`  文件中:

```JSON
{ "availableProviders": "KEEPASS", "defaultProvider": "KEEPASS" }

```

Procedure: 访问远程密码设置

1. 打开 [主窗口](#access_backend_settings)并点击  `文件 | 设置` 。

2. 选择  `外观 行为 | 密码` 。

3. 密码   设置页面显示默认的凭证存储机制，您可以使用这些机制来配置设置。

![默认密码设置](https://resources.jetbrains.com/help/img/idea/2026.3/remote_password_settings_default.png)

4. 请点击   OK   以保存更改。

