# 使用 SSH 连接到数据库

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

本主题为您提供了如何通过 SSH 隧道和跳板主机连接到运行在隔离网络中的数据库的示例。

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

## 云数据库

让我们来看以下示例。 MySQL 数据库远程运行在云中，必须通过跳板主机建立连接。 您需要使用加密的私钥文件进行身份验证。 要创建数据源并运行数据库的测试连接，请执行以下操作：

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.

点击   Add  按钮。

2.

在   主机  和   端口  字段中，指定跳板主机的连接详细信息。 例如，  `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:**
> 对于此身份验证类型，请确保您的公钥文件已提供并存储在跳板主机上。

6.

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

7.

点击   测试连接  以运行跳板主机的测试连接。

![SSH 配置和跳板主机的成功测试连接](https://resources.jetbrains.com/help/img/idea/2026.3/db_ssh_connection_example_config_cloud_success.png)

8.

在   SSH 配置  对话框中，点击   确定  以确认新的 SSH 配置设置。

5. 在   通用  选项卡的   数据源与驱动程序  对话框中，指定您的数据库连接详细信息：

1.

在   主机  和   端口  字段中，指定您的数据库服务器地址和端口号。 例如，  `mysql-ssh.my-account.my-region.amazonaws.com` 和  `3306` 。

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

3.

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

4.  在   数据库  字段中，输入您想要连接的数据库名称。 在我们的示例中，  `testdb` 。

5.

在   URL  字段中，CLion使用其他连接设置的值自动生成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. 点击   确定   创建数据源。

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

## Docker 容器中的数据库

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

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.

点击   Add  按钮。

2.

在   主机  和   端口  字段中，指定运行在 Docker 容器中的跳板主机的连接详细信息。 例如，  `localhost` 和  `2222` 。

3.

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

4.

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

5.

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

> **Note:**
> 对于此身份验证类型，请确保您的公钥文件已提供并存储在跳板主机上。

6.

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

7.

点击   测试连接  以运行跳板主机的测试连接。

![SSH 配置和跳板主机的成功测试连接](https://resources.jetbrains.com/help/img/idea/2026.3/db_ssh_connection_example_config_docker_success.png)

8.

在   SSH 配置  对话框中，点击   确定  以确认新的 SSH 配置设置。

5. 在   通用  选项卡的   数据源与驱动程序  对话框中，指定您的数据库连接详细信息：

1.

在   主机  和   端口  字段中，指定您的数据库服务器地址和端口号。 例如，  `172.19.0.3` 和  `5432` 。 对于基于文件的数据库，请在相应字段中指定数据库文件的路径。

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

3.

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

4.  在   数据库  字段中，输入您想要连接的数据库名称。 在我们的示例中，  `guest` 。

5.

在   URL  字段中，CLion使用其他连接设置的值自动生成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. 点击   确定   创建数据源。

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

