PhpStorm 2026.3 Help

运行 SSH 终端

您可以直接从 PhpStorm 启动一个 SSH Session。 通过在专用的 SSH 终端中运行命令，您可以通过 SSH 隧道访问远程 Web 服务器或 Vagrant 实例（虚拟机）上的数据，主要是上传和下载文件。

设置 SSH 终端

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

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

    有关使用 SSH 密钥的更多信息，请参阅 生成新的 SSH 密钥并将其添加到 ssh-agent 教程。

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

    1. 在 设置 对话框（Ctrl+Alt+S ），转到 工具 | SSH 终端。

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

      • 当前 Vagrant ：选择此选项可在当前正在运行的 Vagrant 虚拟机 上执行 SSH 终端中的命令。

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

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

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

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

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

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

启动 SSH 终端

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

  2. 根据在 工具 | SSH 终端 页面的 设置 对话框（Ctrl+Alt+S ）中定义的连接设置，可能出现以下行为类型：

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

    • 如果选择了 当前 Vagrant 选项，SSH Terminal 将提供对当前运行的 Vagrant 虚拟机的访问。

      有关更多信息，请参阅 Vagrant。

    • 如果选择了 SSH 配置 选项，SSH 终端将会对通过列表中选择的 SSH configuration访问的服务器上的数据进行控制。 如需更多信息，请参阅 创建 SSH 配置。

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

    如果在 PhpStorm 中尚未设置 Vagrant 虚拟机或 SSH 连接，则会打开一个 SSH 会话 对话框，提示您 创建 SSH 配置。

查看 SSH 日志

要对 SSH 连接进行故障排除，请查看 IDE 日志。 对于身份验证错误，还请检查 SSH 服务器日志，或咨询服务器管理员。 位置取决于服务器操作系统和配置。

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

    2026年 11月 9日
    创建 SSH 配置Docker