# 运行 SSH 终端

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

> **TL;DR**
> 添加 SSH 配置：  `设置 | 工具 | SSH 配置`
>
>
>
> 从主菜单启动 SSH 会话：  `工具 | 启动 SSH 会话`
>
>
>
> 配置 SSH 终端：  `设置 | 工具 | SSH 终端`

您可以直接从 CLion 启动一个  SSH Session 。 通过在专用的 SSH 终端中运行命令，您可以通过 SSH 隧道访问远程 Web 服务器上的数据，主要用于上传和下载文件。

Procedure: 设置 SSH 终端

> **Note:**
> 如果您已经配置了 [远程工具链](remote-projects-support.html#remote-toolchain) 和相应的 CMake 配置文件，请跳过此步骤。 在这种情况下，会自动 [创建部署条目](remote-projects-support.html#deployment-entry)，您可以立即运行 SSH 终端（如 [下文](#launch-ssh-terminal)所述）。

1. 确保远程计算机上有 SSH 服务器，并且拥有可访问该服务器的账户。

2. 在  目标环境 上的 SSH 服务器注册一个帐户，并根据服务器策略生成一对 SSH 密钥或密码。

3. 选择远程环境并配置 SSH 终端：

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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))) 中，前往  `工具 | SSH 终端` 。

2.

在   连接设置   区域中，选择远程环境：

* SSH 配置 ：选择此选项，以便在通过某个 [SSH configurations](create-ssh-configurations.html)可访问的本地或远程 Web 服务器上执行 SSH Terminal 中的命令。 * 每次运行时选择 SSH 配置 ：如果选择此选项，您每次从主菜单中选择 `工具 | 启动 SSH 会话` 时，都必须从弹出窗口中选择所需的配置。 * 如果您想要的 SSH 配置未出现在列表中，请点击 设置配置 链接，并在 [SSH Configurations](settings-tools-ssh-configurations.html)页面中定义一个。

若要每次使用同一个 SSH 连接，请选择一个   SSH 配置  。 若要在每次启动会话时选择连接，请选择   每次运行时选择 SSH 配置  。

3.  从   默认编码   列表中，选择要在 SSH 终端中使用的编码。

![SSH 终端设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_sshterminal_settings.png)

Procedure: 启动 SSH 终端

1. 在主菜单中，进入  `工具 | 启动 SSH 会话…` . 或者，调用   帮助 | 查找操作   `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS))对话框，搜索  start ssh.. ，并选择   启动 SSH 会话  。

2. 根据在  `工具 | SSH 终端` 页面的   设置  对话框（ `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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中定义的连接设置，可能会出现以下行为类型：

* 如果选择了 SSH 配置 选项，SSH 终端将会对通过列表中选择的 SSH configuration 访问的服务器上的数据进行控制。 如需了解更多信息，请参阅 [创建 SSH 配置](create-ssh-configurations.html)。

* 如果已选择 每次运行时选择 SSH 配置 选项，CLion 将显示一个列表以选择所需的 SSH 配置 。

如果在 CLion 中尚未设置 Vagrant 虚拟机或 SSH 连接，则会打开一个   SSH 会话   对话框，提示您 [创建 SSH 配置](create-ssh-configurations.html)。

![远程终端](https://resources.jetbrains.com/help/img/idea/2026.3/cl_remote_terminal.animated.gif)

Procedure: 查看 SSH 日志

要对 SSH 连接进行故障排除，请查看 [IDE 日志](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#logs-directory)。 对于身份验证错误，还要检查 SSH 服务器日志或咨询服务器管理员。 其位置取决于服务器操作系统和配置。

例如，在 Fedora 服务器上，运行  `sudo journalctl -u sshd.service`  以查看 SSH 服务器日志。 这些日志可以帮助识别身份验证失败和被拒绝的连接。

## See also

### 流程

[远程开发](remote-development.html)

