# SSH 配置

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

> **TL;DR**
> `文件 | 设置 | 工具 | SSH 配置`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 工具 | SSH 配置`  适用于 macOS
>
>
>
> `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)) !["设置"图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.settings.svg)

此页面用于 [创建 SSH 配置](create-ssh-configurations.html)，这些配置可用于 [配置远程解释器](null)、 [连接到 SFTP 部署服务器](creating-a-remote-server-configuration.html)以及 [启动 SSH 会话](running-ssh-terminal.html)。

![SSH 配置对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/ij_ssh_configuration.png)

|  !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)   添加   `Insert` (Windows), `Insert` (macOS), `Insert` (IntelliJ IDEA Classic (macOS)), `Insert` (macOS System Shortcuts), `Insert` (XWin), `Insert` (GNOME), `Insert` (KDE), `Insert` (Emacs), `Insert` (Sublime Text), `Insert` (Sublime Text (macOS)), `Insert` (Visual Studio), `Insert` (Visual Studio (macOS)), `Insert` (NetBeans), `Insert` (Eclipse), `Insert` (Eclipse (macOS))  |  创建新的 SSH 配置。  |
|  !["移除"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.remove.svg)   删除   `Alt+Delete` (Windows), `Alt+Delete` (macOS), `Alt+Delete` (IntelliJ IDEA Classic (macOS)), `Alt+Delete` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `Alt+Delete` (Sublime Text (macOS)), `Alt+Delete` (Visual Studio), `Alt+Delete` (Visual Studio (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |     删除所选的 SSH 配置。      > **Note:** > 这将影响依赖于此配置的 [已配置的远程解释器](null)、 [SFTP 部署服务器](creating-a-remote-server-configuration.html)和 [SSH 会话](running-ssh-terminal.html)。    |
|  ![复制按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.copy.svg)   复制   `Ctrl+D` (Windows), `Ctrl+D` (macOS), `Ctrl+D` (IntelliJ IDEA Classic (macOS)), `Ctrl+D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Ctrl+D` (Emacs), `Ctrl+D` (Sublime Text), `Ctrl+D` (Sublime Text (macOS)), `Ctrl+D` (Visual Studio), `Ctrl+D` (Visual Studio (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Eclipse), `Ctrl+D` (Eclipse (macOS))  |  创建所选 SSH 配置的副本。  |
|  ![重命名按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app-client.expui.general.edit.svg)   重命名   `Shift+F6` (Windows), `⇧ F6` (macOS), `⇧ F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ R` (macOS System Shortcuts), `Shift+F6` (XWin), `Shift+F6` (GNOME), `Shift+F6` (KDE), `Shift+F6` (Emacs), `Shift+F6` (Sublime Text), `⇧ F6` (Sublime Text (macOS)), `Ctrl+R, R` (Visual Studio), `⌘ R, R` (Visual Studio (macOS)), `Ctrl+R` (NetBeans), `Alt+Shift+R` (Eclipse), `⇧ F6` (Eclipse (macOS))  |  重命名所选的 SSH 配置。  |

## SSH 配置设置

|    SSH 会话后端    |     选择用于此 SSH 配置的 SSH 会话后端。 此选项允许不同的 SSH 连接使用不同的后端。        * 遗留 ：使用旧版 SSHJ 库。    * OpenSSH ：使用 OpenSSH 库。      如果 SSH 连接在一个后端上失败，请尝试切换到另一个后端。     |
|    仅对该项目可见    |     将此 SSH 配置限制为当前项目。 该配置将不会在其他项目中可用。 IntelliJ IDEA 将这些配置存储在项目的  `.idea`  目录中，您可以在团队成员之间通过 [VCS](version-control-integration.html) 共享。       默认情况下，此选项是禁用的，IntelliJ IDEA 将 SHH 配置存储在 [IDE 配置目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#config-directory)中。 在这种情况下，您可以在从当前 IntelliJ IDEA 实例工作时，将此配置用于任何项目。     |
|    主持人    |  指定要连接的服务器的主机名。 默认值为  `本地主机` 。  |
|    用户名    |  指定用于服务器身份验证的用户名。  |
|    端口    |  指定要连接的远程端口号。 默认值是  `22` （SSH 的标准 TCP 端口）。  |
|    身份验证类型    |     请选择客户端身份验证方法：        * 密码 ：使用指定的密码进行身份验证，并在必要时记住它。    * 密钥对 ：使用 [SSH 认证](http://www.ssh.com/)与密钥对（OpenSSH 或 PuTTY）。 指定私钥文件的位置及相应的认证密码。 公钥应该在远程服务器上。 如果需要，请记住密码短语。    * OpenSSH 配置和身份验证代理 ：使用用于管理 SSH 密钥的凭据帮助程序应用程序，例如 [ssh-agent](https://en.wikipedia.org/wiki/Ssh-agent)。 例如，参见以下教程： [Generating a new SSH key and adding it to the ssh-agent](https://docs.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)。    |
|    解析配置文件 ~/.ssh/config    |     请阅读 [OpenSSH 客户端配置文件](https://www.ssh.com/academy/ssh/config) 以获取对应主机的 SSH 配置中未指定的任何选项。       此选项仅适用于   密码  和   密钥对  认证类型。 通过   OpenSSH 配置和身份验证代理  ，IntelliJ IDEA 会读取 OpenSSH 配置文件。       有关更多信息，请参阅 [支持的 OpenSSH 指令](create-ssh-configurations.html#openssh-directives)、 [运行 SSH 终端](null)。     |
|    测试连接    |  尝试使用当前的 SSH 配置设置进行连接。  |

### 连接参数

|    每隔    |  发送定期数据包以保持 SSH 连接活动。 如果没有定期消息，远程服务器可能会关闭连接。 设置消息周期，以秒为单位。  |
|    严格的主机密钥检查    |     指定如何处理新的和更改的主机密钥。        * 是 ：切勿将新的主机密钥添加到用户的 known_hosts 文件，并且绝不允许连接到密钥已更改的主机。    * 接受新的 ：始终将新主机密钥添加到用户的 known_hosts 文件，但绝不允许连接到主机密钥已更改的主机。    * 否 ：始终将新主机密钥添加到用户的 known_hosts 文件中，并允许连接到主机密钥已更改的主机。    * 询问 ：仅在确认后将新的主机密钥添加到用户的 known_hosts 文件，并且绝不允许连接到主机密钥已更改的主机。 这是默认行为。    |
|    对 knownhosts 文件中的主机进行哈希处理    |  将新的主机记录存储为哈希格式。  |

## See also

### 过程

[创建 SSH 配置](create-ssh-configurations.html)