# 从 IntelliJ IDEA 连接到远程服务器

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

> **TL;DR**
> 确保满足 [先决条件](prerequisites.html)。

由于远程工作成为必要，IntelliJ IDEA 提供了远程开发功能，以帮助您远程编写代码、运行、调试和部署项目。

## 通过 SSH 连接

通过 SSH 连接到远程服务器，并且可以直接从 IntelliJ IDEA 的欢迎屏幕启动连接。

> **Note:**
> 要访问欢迎屏幕，请 [启动 IntelliJ IDEA](installation-guide.html)。 如果没有打开任何项目，将会打开欢迎屏幕。

![IntelliJ IDEA 主屏幕](https://resources.jetbrains.com/help/img/idea/2026.3/develop-remotely-welcome-screen.png)

Procedure: 连接到远程服务器并打开远程项目

1. 确保已启用捆绑的 [JetBrains OS 集成](https://plugins.jetbrains.com/plugin/31636-jetbrains-os-integration) 插件。

2. 在 IntelliJ IDEA 主屏幕上，点击   连接到远程  。 或者，在主菜单中转到  `文件 | 连接到远程` 。

3. 在   连接到远程  对话框中，点击   SSH  。

如果 IDE 已在远程服务器上运行，并且有一个 [连接链接](remote-development-a.html#use_idea)，可以点击   链接  ，并将实际链接添加到   连接到运行中的 IDE   部分下的字段中。

4. 如果没有任何最近使用的配置，请从下拉菜单中选择   SSH 配置   以打开 [SSH 配置](settings-tools-ssh-configurations.html) 设置。

![IntelliJ IDEA 欢迎屏幕](https://resources.jetbrains.com/help/img/idea/2026.3/connect_to_ssh.png)

5. 配置远程服务器连接参数，点击   测试连接   以确保与远程服务器的连接成功，然后点击   OK   保存更改。

6. 返回   连接到远程   对话框后，添加 SSH 连接并点击   连接  。

7. 指定项目目录并点击   打开项目   或   跳过并打开 IDE  。

有关如何开始使用单独的   JetBrains Gateway   安装程序的信息，请参阅 [JetBrains Gateway](remote-development-a.html#gateway)。

如需了解有关添加插件或 SDK 的更多信息，请参阅相应的 [Getting Started](work-inside-remote-project.html#plugins)部分。

## 连接到在 WSL2 上运行的项目

您可以配置 IDE 后端，使其直接在 WSL2 中启动。

在开始连接 WSL 之前，请检查 [现有的先决条件](prerequisites-for-dev-containers.html)并确保满足附加条件：

* 计算机上已安装 Windows 10 或 11 版本，并在 WSL2 下安装了 Ubuntu 20.04 版本。

* Windows 计算机上已配置 WSL2。 有关详细信息，请参阅 [WSL2 配置](https://www.jetbrains.com/zh-cn/help/idea/how-to-use-wsl-development-environment-in-product.html#wsl-general)部分。

Procedure: 连接到 WSL

1. 请确保 [远程开发 Gateway 插件已启用](jetbrains-gateway.html#plugin_install)。

2. 在 IntelliJ IDEA 的欢迎界面，选择   远程开发  。

3. 在   远程开发   下，选择   WSL  。

4. 点击   新建连接  。

![新建连接](https://resources.jetbrains.com/help/img/idea/2026.3/wsl_new_connection.png)

5. 在下一页，选择 WSL 实例并点击   下一步  。

![选择 WSL 实例](https://resources.jetbrains.com/help/img/idea/2026.3/ij_choose_wsl_instance.png)

6. 在下一页，选择 IDE 版本和要打开的项目。 点击   启动 IDE 并连接  。

![选择 IDE 版本和项目](https://resources.jetbrains.com/help/img/idea/2026.3/ij_choose_ide_and_project.png)

连接已建立，后端 IDE 已下载，项目会在 JetBrains Client 中打开。