使用 SSH 连接到数据库

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

有关在 PyCharm 中使用 SSH 的更多信息，请参阅 SSH 和 SSL 主题。

云数据库

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

在数据库工具窗口中，点击工具栏上的新建，然后导航到数据源 | MySQL。
点击 SSH/SSL 选项卡，并选中使用 SSH 隧道复选框。
点击添加 SSH 配置。
在 SSH 配置对话框中，按以下步骤添加新配置：
1. 点击添加按钮。
2. 在主持人和端口字段中，指定跳板主机的连接详细信息。例如， my-jump-host.amazonaws.com、 22。
3. 在用户名字段中输入您的用户名。
4. 在本教程中，我们使用加密的私钥文件和公钥文件进行身份验证。从身份验证类型列表中，选择密钥对.
5. 要提供您的私钥文件，请在私钥文件字段中点击浏览并选择该文件。
  对于此身份验证类型，请确保已提供公钥文件并将其存储在跳板主机上。
6. 在密码短语字段中指定您的密码短语。
7. 点击测试连接以对跳板主机运行测试连接。
8. 在 SSH 配置对话框中，点击确定以确认新的 SSH 配置设置。
在数据源与驱动程序对话框的通用选项卡上，指定数据库连接详细信息：
1. 在主持人和端口字段中，指定数据库服务器地址和端口号。例如， mysql-ssh.my-account.my-region.amazonaws.com 和 3306。
2. 从身份验证下拉列表中选择用户 & 密码。
3. 在用户和密码字段中输入您的用户凭据。
4. 在数据库字段中输入要连接的数据库名称。在我们的示例中， testdb。
5. 在 URL 字段中，PyCharm 生成的 JDBC URL 会自动使用其他连接设置的值。
  如果需要使用带有某些其他设置的 JDBC URL，请将其粘贴到 URL 字段中。
  例如， jdbc:mysql://my-endpoint.amazonaws.com:3306/testdb.
在连接详细信息区域的底部，点击测试连接链接以启动到数据库的测试连接。
点击确定创建数据源。

位于 Docker 容器中的数据库

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

在数据库工具窗口中，点击工具栏上的新建，然后导航到数据源 | PostgreSQL。
点击 SSH/SSL 选项卡，并选中使用 SSH 隧道复选框。
点击添加 SSH 配置。
在 SSH 配置对话框中，按以下步骤添加新配置：
1. 点击添加按钮。
2. 在主持人和端口字段中，指定跳板主机运行在 Docker 容器中的连接详细信息。例如， localhost 和 2222。
3. 在用户名字段中输入您的用户名。
4. 在本教程中，我们使用加密的私钥文件和公钥文件进行身份验证。从身份验证类型列表中，选择密钥对.
5. 要提供您的私钥文件，请在私钥文件字段中点击浏览并选择该文件。
  对于此身份验证类型，请确保已提供公钥文件并将其存储在跳板主机上。
6. 在密码短语字段中指定您的密码短语。
7. 点击测试连接以对跳板主机运行测试连接。
8. 在 SSH 配置对话框中，点击确定以确认新的 SSH 配置设置。
在数据源与驱动程序对话框的通用选项卡上，指定数据库连接详细信息：
1. 在主持人和端口字段中，指定数据库服务器地址和端口号。例如， 172.19.0.3 和 5432。对于基于文件的数据库，请在相应字段中指定数据库文件的路径。
2. 从身份验证下拉列表中选择用户 & 密码。
3. 在用户和密码字段中输入您的用户凭据。
4. 在数据库字段中输入要连接的数据库名称。在我们的示例中， guest。
5. 在 URL 字段中，PyCharm 生成的 JDBC URL 会自动使用其他连接设置的值。
  如果需要使用带有某些其他设置的 JDBC URL，请将其粘贴到 URL 字段中。
  例如， jdbc:postgresql://172.19.0.3:5432/guest。
在连接详细信息区域的底部，点击测试连接链接以启动到数据库的测试连接。
点击确定创建数据源。

2026年 3月 24日