# 使用 SSH 连接到数据库

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

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

有关如何在 IntelliJ IDEA 中使用 SSH 的更多信息，请参阅 [SSH 和 SSL](configuring-ssh-and-ssl.html#ssh) 主题。

## 云数据库

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

Procedure:

1. 在   数据库   工具窗口中，点击工具栏上的 ![新建图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)   新建   并导航到  `数据源 | MySQL` 。

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

3. 点击 ![添加 SSH 配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)   添加 SSH 配置  。

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

1.

点击   添加   按钮。

2.

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

3.

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

4.

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

5.

要提供私有密钥文件，请点击 ![浏览图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.inline.browse.svg)   浏览  ，在   私有密钥文件   字段中选择该文件。

> **Note:**
> 对于此身份验证类型，请确保已提供公有密钥文件并将其存储在 jump host 上。

6.

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

7.

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

![SSH 配置以及与 jump host 的成功测试连接](https://resources.jetbrains.com/help/img/idea/2026.3/db_ssh_connection_example_config_cloud_success.png)

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. 点击连接详细信息区域底部的   测试连接   链接，以启动与数据库的测试连接。

![测试连接链接](https://resources.jetbrains.com/help/img/idea/2026.3/db_test_connection_link.png)

7. 点击   OK   创建数据源。

![MySQL \[Cloud, SSH\] 数据源的连接设置](https://resources.jetbrains.com/help/img/idea/2026.3/db_ssh_connection_example_data_source_cloud.png)

## Docker 容器中的数据库

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

Procedure:

1. 在   数据库   工具窗口中，点击工具栏上的 ![新建图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)   新建   并导航到  `数据源 | PostgreSQL` 。

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

3. 点击 ![添加 SSH 配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)   添加 SSH 配置  。

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

1.

点击   添加   按钮。

2.

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

3.

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

4.

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

5.

要提供私有密钥文件，请点击 ![浏览图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.inline.browse.svg)   浏览  ，在   私有密钥文件   字段中选择该文件。

> **Note:**
> 对于此身份验证类型，请确保已提供公有密钥文件并将其存储在 jump host 上。

6.

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

7.

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

![SSH 配置以及与 jump host 的成功测试连接](https://resources.jetbrains.com/help/img/idea/2026.3/db_ssh_connection_example_config_docker_success.png)

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. 点击连接详细信息区域底部的   测试连接   链接，以启动与数据库的测试连接。

![测试连接链接](https://resources.jetbrains.com/help/img/idea/2026.3/db_test_connection_link.png)

7. 点击   OK   创建数据源。

![MySQL \[Cloud, SSH\] 数据源的连接设置](https://resources.jetbrains.com/help/img/idea/2026.3/db_ssh_connection_example_data_source_docker.png)