PhpStorm 2026.3 Help

创建 SSH 配置

在 PhpStorm 中,您可以将远程服务器的 SSH 连接参数保存为专用的 SSH 配置。 创建的配置随后可用于 配置远程解释器、 连接到 SFTP 部署服务器或 启动 SSH 会话。

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

  2. 在左侧窗格中,点击 添加项。

  3. 使用 仅对该项目可见 复选框以启用在其他项目中重用此服务器访问配置。

    • 选中复选框以将 SSH 配置的使用限制于当前项目。 这样的 SSH 配置无法在当前项目之外重用。 它没有出现在其他项目的可用配置列表中。

      项目特定的配置存储在 .idea 目录中。 在 通过版本控制 共享这些文件之前,请先检查这些文件。 可用于所有项目的服务器配置存储在 IDE 设置中。

    • 当复选框被清除时,SSH 配置在所有 PhpStorm 项目中是可见的。 其设置可在多个项目之间复用。

  4. 在 主机、 用户名 和 端口 字段中,指定连接参数。

  5. 选择认证到服务器的方式。 请执行以下操作之一:

    • 密码 :使用密码访问主机。 要将密码保存在 PhpStorm 中,请选中 保存密码 复选框。

    • 密钥对(OpenSSH 或 PuTTY) :使用 SSH 认证与密钥对。 要应用此身份验证方法,您必须在客户端计算机上拥有私钥,并在远程服务器上拥有公钥。 PhpStorm 支持使用 OpenSSH 工具生成的私钥。

      指定存储您 私钥 的文件路径,并在相应字段中输入密码短语(如果有)。 要让 PhpStorm 记住该密码短语,请选中 保存密码短语 复选框。

    • OpenSSH 配置与认证代理 :使用管理您的 SSH 密钥的凭据助手应用程序,例如 ssh-agent 或 Pageant(仅限 Windows)。

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

    如果您选择 OpenSSH 配置选项,PhpStorm 将解析记录在 SSH 配置文件中的 OpenSSH 指令: /etc/ssh/ssh_config > 和 ~/.ssh/config (适用于 Linux 和 macOS),或 C:\Users\<username>\.ssh\config (适用于 Windows)。 PhpStorm 支持一组有限的 OpenSSH 指令。

  6. 请点击 测试连接 按钮以确保设置正确且 PhpStorm 可以连接到目标服务器。

支持的 OpenSSH 指令

使用 OpenSSH 配置与认证代理 时,PhpStorm 会读取 SSH 配置文件。 在 设置 | 高级设置 | SSH | 配置文件解析器 中选择读取方式。

默认的 OpenSSH 选项要求计算机上安装 OpenSSH,并运行 ssh -G 来读取配置。 随后,PhpStorm 会应用其 SSH 实现支持的设置,而不是所有 OpenSSH 功能。

遗留 选项使用内置于 PhpStorm 的解析器,该解析器支持以下指令:

2026年 11月 9日