PyCharm 2026.3 Help

运行 SSH 终端

您可以直接从 PyCharm 启动 SSH 会话。 在专用 SSH 终端中运行命令,您可以通过 SSH 隧道访问远程服务器或默认远程解释器上的数据,主要用于上传与下载文件。

设置 SSH 终端

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

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

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

    1. 在 设置 对话框(Ctrl+Alt+S ),转到 工具 | SSH 终端。

    2. 在 连接设置 区域中,选择远程环境:

      • 默认远程解释器 :选择此选项可在默认 远程解释器运行的同一主机上执行 SSH 终端中的命令。

      • SSH 配置 :选择此选项可在可通过任一 SSH 配置 访问的本地或远程 Web 服务器上执行 SSH 终端中的命令。

        • 每次运行时选择 SSH 配置 :如果选择此选项,则每次从主菜单选择 工具 | 启动 SSH 会话 时,您都需要在弹出窗口中选择所需的配置。

        • 如果所需的 SSH 配置未显示在列表中,请点击 设置配置 链接,并在 SSH 配置页面中进行定义。

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

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

启动 SSH 终端

  1. 在主菜单中,转到 工具 | 启动 SSH 会话…。 或者,打开 帮助 | 查找操作 Ctrl+Shift+A 对话框,搜索 start ssh.. ,然后选择 启动 SSH 会话。

  2. 根据在 设置 对话框(Ctrl+Alt+S )的 工具 | SSH 终端 页面中定义的连接设置,可能出现以下行为:

    • 如果选择了 默认远程解释器 选项,SSH 终端将提供对默认远程解释器运行的同一主机的访问。

    • 如果选择了 SSH 配置 选项,SSH 终端将允许您控制通过列表中所选 SSH 配置 可访问的服务器上的数据。 有关更多信息,请参阅 创建 SSH 配置。

    • 如果选择了 每次运行时选择 SSH 配置 选项,PyCharm 将显示一个列表,供您选择所需的 SSH 配置。

    如果尚未在 PyCharm 中设置 SSH 连接,将打开一个 SSH 会话 对话框,提示您 创建 SSH 配置。

查看 SSH 日志

要排查 SSH 连接问题,请查看 IDE 日志。 对于身份验证错误,还要检查 SSH 服务器日志或询问服务器管理员。 其位置取决于服务器操作系统和配置。

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

    2026年 11月 3日