IntelliJ IDEA 2025.2 Help

配置 SSH 和 SSL

为了使与数据库的连接更加安全,一些服务需要使用 SSH 或 SSL。

SSL

以下过程描述了适合大多数数据库的 SSL 配置。 对于某些数据库,您需要采用另一种方法才能成功连接。 您可以在 DataGrip 文档中看到 CassandraHeroku Postgres 的配置示例。

连接到支持 SSL 的数据库

  1. 执行以下任一操作以打开数据源属性:

    • 数据库 工具窗口工具栏中,点击 数据源图标数据源

    • 请按 Shift+Enter.

    打开数据源与驱动程序对话框
  2. 数据源 选项卡上,选择您要修改的数据源。

  3. 点击 SSH/SSL 选项卡并选择 使用SSL(L) 复选框。

  4. CA 文件(A) 字段中,导航到 CA 证书文件(例如, mssql.pem )。

  5. 您可以将证书文件字段留空,并使用信任库从中包含的证书中获取所需的证书。 要实现这一点,勾选 使用信任库 复选框并选择您要使用的 truststore。

    • IDE :使用 IDE 接受的证书。 您可以在 设置 | 外观和行为 | 系统设置 | 服务器证书 中添加新的已接受证书。

    • JAVA :使用 JAVA 信任库证书。

    • 系统: 使用系统信任库证书。

  6. 客户端证书文件 字段中,导航至客户端证书文件(例如, client-cert.pem )。

  7. 客户端密钥文件(K) 字段中,导航到客户端密钥文件(例如, client-key.pem )。

  8. 模式 列表中选择验证模式:

    需要

    验证服务器是否识别客户端证书(如果提供了证书)。

    验证CA

    • 验证服务器是否识别客户端证书(如果提供了证书)。

    • 通过检查一直到存储在客户端上的根证书的证书链来验证服务器。

    全面验证

    • 验证服务器是否识别客户端证书(如果提供了证书)。

    • 通过检查一直到存储在客户端上的根证书的证书链来验证服务器。

    • 验证服务器主机以确保其与存储在服务器证书中的名称匹配。

    如果任何一个证书无法验证,SSL 连接将失败。

  9. 为了确保数据源连接成功,请点击 测试连接

    连接到支持 SSL 的数据库

禁用与数据库的 SSL 连接

  1. 执行以下任一操作以打开数据源属性:

    • 数据库 工具窗口工具栏中,点击 数据源图标数据源

    • 请按 Shift+Enter.

    打开数据源与驱动程序对话框
  2. 数据源 选项卡上,选择您要修改的数据源。

  3. 点击 SSH/SSL 选项卡并取消选中 使用SSL(L) 复选框。

  4. 点击 应用

从其他数据源复制 SSL 设置

如果您为一个数据源配置了 SSL 设置,您可以将其复制到另一个数据源。

  1. 执行以下任一操作以打开数据源属性:

    • 数据库 工具窗口工具栏中,点击 数据源图标数据源

    • 请按 Shift+Enter.

    打开数据源与驱动程序对话框
  2. 数据源 选项卡上,选择您要修改的数据源。

  3. 点击 SSH/SSL 选项卡并选择 使用SSL(L) 复选框。

  4. 点击 复制自… 链接并选择您想要复制的配置。

SSH

安全外壳或 SSH 是一种网络协议,用于加密客户端和服务器之间的连接。

在 IntelliJ IDEA 中,您可以通过以下方式之一创建一个 SSH 连接:

IntelliJ IDEA SSH隧道

IntelliJ IDEA 可以基于您设置的 SSH 配置创建 SSH 隧道。 要访问 SSH 配置设置,请按 Ctrl+Alt+S 打开设置并选择 工具 | SSH 配置

若要为数据源使用 SSH 隧道,请在 SSH/SSL 选项卡的 使用 SSH 隧道 复选框中打勾,在 数据源和驱动程序 对话框(Shift+Enter )中进行设置。

"您在项目中创建的所有 SSH 连接都将在所有数据源之间共享。" 如果您不想在项目之间共享连接,请在 SSH 连接设置中选择 仅对此项目可见 复选框。

通过 SSH 连接数据库

  1. 执行以下任一操作以打开数据源属性:

    • 数据库 工具窗口工具栏中,点击 数据源图标数据源

    • 请按 Shift+Enter.

    打开数据源与驱动程序对话框
  2. 选择要为其设置 SSH 连接的数据源。

  3. 点击 SSH/SSL 选项卡并选择 使用SSH 隧道(H) 复选框。

  4. 点击 添加 SSH 配置添加SSH 配置

  5. SSH 配置 对话框中,点击 添加 按钮。

  6. 如果您不想在项目之间共享配置,请选择 仅对此项目可见 复选框。

  7. 主机端口 字段中,指定您的连接详细信息。

  8. 用户名(U) 字段中输入您的用户名。

  9. 本教程中,我们使用加密的私钥文件和公钥文件进行身份验证。 从 身份验证类型(Y) 列表中,您可以选择一种认证方法:

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

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

      指定存储 private key 的文件路径,并在相应字段中输入密码短语(如果有)。 若要使 IntelliJ IDEA 记住密码短语,请选中 保存密码短语(E) 复选框。

    • OpenSSH 配置和身份验证代理 :使用凭据助手应用程序来管理您的 SSH 密钥,例如 ssh-agentPageant(仅限 Windows)

  10. 点击 测试连接 以运行测试连接。

  11. SSH 配置 对话框中,点击 OK 以确认新的 SSH 配置设置。

  12. 本地端口 字段的 数据源和驱动程序 对话框中,指定您想要转发连接的本地端口号。 否则,IntelliJ IDEA 动态选择端口。

  13. 点击连接详细信息区域底部的 测试连接 链接以启动数据库的测试连接。

    测试连接链接
  14. 点击 确定 创建数据源。

数据源的 SSH 设置

示例

有关使用 SSH 连接到数据库的示例,请参阅 通过 SSH 连接数据库 主题。

禁用 SSH 连接到数据库

  1. 执行以下任一操作以打开数据源属性:

    • 数据库 工具窗口工具栏中,点击 数据源图标数据源

    • 请按 Shift+Enter.

    打开数据源与驱动程序对话框
  2. 选择您想要更改连接设置的数据源配置文件。

  3. 点击 SSH/SSL 选项卡并取消选中 使用SSH 隧道(H) 复选框。

  4. 点击 应用

手动创建 SSH 隧道

使用 PuTTY(Windows)创建 SSH 隧道

  1. 下载并运行最新版本的 PuTTY SSH 和 Telnet 客户端(从 https://www.putty.org/ 下载客户端)。

  2. PuTTY配置 对话框中,导航到 连接 | SSH | 身份验证

  3. 用于身份验证的私钥文件 字段中,指定您的私钥文件的路径,然后点击 打开

  4. 在命令行窗口中,指定您用于 SSH 隧道的用户名,然后按 Enter。 请勿关闭命令行窗口。

  5. 数据库 工具窗口中,点击工具栏上的 数据源属性 图标 """
数据源属性图标
"""

  6. 选择您想要更改连接设置的数据源配置文件。

  7. 点击 SSH/SSL 选项卡并选择 使用 SSH 隧道 复选框。

  8. 身份验证类型 列表中选择 OpenSSH 配置和认证代理

  9. 代理主机代理用户端口 字段中,指定连接详细信息。

  10. 为了确保数据源连接成功,请点击 测试连接

使用 PuTTY(Windows)创建 SSH 隧道

使用 Pageant(Windows)创建 SSH 隧道

Pageant 是 PuTTY、PSCP、PSFTP 和 Plink 的 SSH 认证代理。 Pageant 存储 您 的私钥,只要它在运行,它就会将解锁的私钥提供给 PuTTY 或其他工具,如 IntelliJ IDEA。 您可以在 Windows 任务栏中找到 Pageant 图标。

  1. 下载最新版本的 Pageant(从 https://www.putty.org/ 下载客户端)。

  2. 在 Windows 任务栏中,右键点击 Pageant 图标,然后选择 添加 Key

  3. 选择私钥文件 对话框中,导航到私钥文件( PPK 文件)并点击 打开

  4. (可选)输入私钥密码并按 Enter

  5. 数据库 工具窗口中,点击工具栏上的 数据源属性 图标 """
数据源属性图标
"""

  6. 选择您想要更改连接设置的数据源配置文件。

  7. 点击 SSH/SSL 选项卡并选择 使用 SSH 隧道 复选框。

  8. 身份验证类型 列表中选择 OpenSSH 配置和认证代理

  9. 代理主机代理用户端口 字段中,指定连接详细信息。

  10. 为了确保数据源连接成功,请点击 测试连接

使用 Pageant(Windows)创建 SSH 隧道

使用 ssh-agent 创建 SSH 隧道(macOS 和 Linux)

在命令行中运行所有 ssh-agent 命令。

  1. 确保 ssh-agent 正在运行。

    ssh-agent
  2. 将您的 key 添加到代理中(在以下示例中,key 路径为 ~/.ssh/id_rsa )。

    ssh-add ~/.ssh/id_rsa
  3. (可选)在 macOS 上,您可以将 -K 选项添加到 ssh-add 命令,以便将密码短语存储在您的钥匙串中。 在 macOS Sierra 及其之后的版本中,您需要在 ~/.ssh/ 中创建 配置 文件,内容如下:

    Host * UseKeychain yes AddKeysToAgent yes IdentityFile ~/.ssh/id_rsa

    如您在 .ssh 目录中有其他私钥,请为每个私钥添加一行 IdentityFile。 例如,如果第二个密钥具有 id_ed25519 名称,请将 IdentityFile ~/.ssh/id_ed25519 作为第二个私钥的附加行。

  4. 列出所有添加的键。

    ssh-add -L
  5. 数据库 工具窗口中,点击工具栏上的 数据源属性 图标 """
数据源属性图标
"""

  6. 选择您想要更改连接设置的数据源配置文件。

  7. 点击 SSH/SSL 选项卡并选择 使用 SSH 隧道 复选框。

  8. 身份验证类型 列表中选择 OpenSSH 配置和认证代理

  9. 代理主机代理用户端口 字段中,指定连接详细信息。

  10. 为了确保数据源连接成功,请点击 测试连接

使用 ssh-agent 创建 SSH 隧道(macOS 和 Linux)
最后修改日期: 2025年 9月 22日