llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

使用 SSH 连接到数据库

本主题提供示例,说明如何通过 SSH 隧道和 jump host(也称为跳转服务器或堡垒主机)连接到在隔离网络中运行的数据库。

有关如何在 IntelliJ IDEA 中使用 SSH 的更多信息,请参阅 SSH 和 SSL 主题。

云数据库

请考虑以下示例。 MySQL 数据库在云中远程运行,必须通过 jump host 建立连接。 需要使用加密的私有密钥文件进行身份验证。 要创建数据源并运行到数据库的测试连接,请执行以下操作:

  1. 在 数据库 工具窗口中,点击工具栏上的 新建图标新建 并导航到 数据源 | MySQL。

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

  3. 点击 添加 SSH 配置添加 SSH 配置。

  4. 在 SSH 配置 对话框中,通过执行以下操作添加新配置:

    1. 点击 添加 按钮。

    2. 在 主持人 和 端口 字段中,指定 jump host 的连接详细信息。 例如, my-jump-host.amazonaws.com, 22。

    3. 在 用户名 字段中输入用户名。

    4. 本教程使用加密的私钥文件和公钥文件进行身份验证。 从 身份验证类型 列表中选择 密钥对。

    5. 要提供私有密钥文件,请点击 浏览图标浏览 ,在 私有密钥文件 字段中选择该文件。

    6. 在 密码短语 字段中指定密码短语。

    7. 点击 测试连接 运行与 jump host 的测试连接。

      SSH 配置以及与 jump host 的成功测试连接
    8. 在 SSH 配置 对话框中,点击 OK 以确认新的 SSH 配置设置。

  5. 在 数据源和驱动程序 对话框的 常规 选项卡上,指定数据库连接详细信息:

    1. 在 主持人 和 端口 字段中,指定数据库服务器地址和端口号。 例如, mysql-ssh.my-account.my-region.amazonaws.com 和 3306。

    2. 从 身份验证 下拉列表中选择 用户 & 密码。

    3. 在 用户 和 密码 字段中,输入您的用户凭证。

    4. 在 数据库 字段中,输入您要连接的数据库名称。 在此示例中, testdb。

    5. 在 URL 字段中,IntelliJ IDEA 将根据其他连接设置的值自动生成 JDBC URL。

      如果您需要使用带有某些附加设置的 JDBC URL,请将其粘贴到 URL 字段中。

      例如, jdbc:mysql://my-endpoint.amazonaws.com:3306/testdb。

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

    测试连接链接
  7. 点击 OK 创建数据源。

MySQL [Cloud, SSH] 数据源的连接设置

Docker 容器中的数据库

在此示例中,PostgreSQL 数据库在 Docker 容器中运行,并且无法直接访问。 必须通过在另一个 Docker 容器中运行的 jump host 建立连接。 需要使用加密的私有密钥文件进行身份验证。 要创建数据源并运行到数据库的测试连接,请执行以下操作:

  1. 在 数据库 工具窗口中,点击工具栏上的 新建图标新建 并导航到 数据源 | PostgreSQL。

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

  3. 点击 添加 SSH 配置添加 SSH 配置。

  4. 在 SSH 配置 对话框中,通过执行以下操作添加新配置:

    1. 点击 添加 按钮。

    2. 在 主持人 和 端口 字段中,指定在 Docker 容器中运行的 jump host 的连接详细信息。 例如, 本地主机 和 2222。

    3. 在 用户名 字段中输入用户名。

    4. 本教程使用加密的私钥文件和公钥文件进行身份验证。 从 身份验证类型 列表中选择 密钥对。

    5. 要提供私有密钥文件,请点击 浏览图标浏览 ,在 私有密钥文件 字段中选择该文件。

    6. 在 密码短语 字段中指定密码短语。

    7. 点击 测试连接 运行与 jump host 的测试连接。

      SSH 配置以及与 jump host 的成功测试连接
    8. 在 SSH 配置 对话框中,点击 OK 以确认新的 SSH 配置设置。

  5. 在 数据源和驱动程序 对话框的 常规 选项卡上,指定数据库连接详细信息:

    1. 在 主持人 和 端口 字段中,指定数据库服务器地址和端口号。 例如, 172.19.0.3 和 5432。 对于基于文件的数据库,请在相应字段中指定数据库文件的路径。

    2. 从 身份验证 下拉列表中选择 用户 & 密码。

    3. 在 用户 和 密码 字段中,输入您的用户凭证。

    4. 在 数据库 字段中,输入您要连接的数据库名称。 在此示例中, 访客。

    5. 在 URL 字段中,IntelliJ IDEA 将根据其他连接设置的值自动生成 JDBC URL。

      如果您需要使用带有某些附加设置的 JDBC URL,请将其粘贴到 URL 字段中。

      例如, jdbc:postgresql://172.19.0.3:5432/guest。

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

    测试连接链接
  7. 点击 OK 创建数据源。

MySQL [Cloud, SSH] 数据源的连接设置
2026年 11月 3日