使用 SSH 连接到数据库
2026-07-09 05:29:19使用 SSH 连接到数据库本主题为您提供了如何通过 SSH 隧道和 jump host(也称为 jump server 或堡垒主机)连接到运行在隔离网络中的数据库的示例。
有关在 DataGrip 中使用 SSH 的更多信息,请参阅 SSH 和 SSL主题。
云数据库让我们来看以下示例。 MySQL 数据库远程运行在云中,必须通过跳板主机建立连接。 您需要使用加密的私钥文件进行身份验证。 要创建数据源并运行数据库的测试连接,请执行以下操作:
在 数据库资源管理器 (⌘ 1 )中,点击工具栏上的 新建 ,并导航到 数据源 | MySQL。
点击 SSH/SSL 选项卡并选中 使用 SSH 隧道 复选框。
点击 添加 SSH 配置。
在 SSH 配置 对话框中,通过以下操作添加新配置:
点击 Add 按钮。
在 主机 和 端口 字段中,指定跳板主机的连接详细信息。 例如, my-jump-host.amazonaws.com, 22。
在 用户名 字段中输入您的用户名。
在本教程中,我们使用加密的私钥文件和公钥文件进行身份验证。 从 认证类型 列表中选择 密钥对。
要提供您的私钥文件,请点击 浏览 ,在 私钥文件 字段中选择文件。
对于此身份验证类型,请确保您的公钥文件已提供并存储在跳板主机上。
在 密码短语 字段中指定您的密码短语。
点击 测试连接 以运行跳板主机的测试连接。
在 SSH 配置 对话框中,点击 确定 以确认新的 SSH 配置设置。
在 通用 选项卡的 数据源与驱动程序 对话框中,指定您的数据库连接详细信息:
在 主机 和 端口 字段中,指定您的数据库服务器地址和端口号。 例如, mysql-ssh.my-account.my-region.amazonaws.com 和 3306。
从 身份验证 下拉列表中选择 用户&密码。
在 User 和 密码 字段中,输入您的用户凭证。
在 数据库 字段中,输入您想要连接的数据库名称。 在我们的示例中, testdb。
在 URL 字段中,DataGrip使用其他连接设置的值自动生成JDBC URL。
如果您需要使用包含某些附加设置的 JDBC URL,请将其粘贴到 URL 字段中。
例如, jdbc:mysql://my-endpoint.amazonaws.com:3306/testdb.
点击连接详细信息区域底部的 测试连接 链接以启动到数据库的测试连接。
请点击 确定 以创建数据源。
Docker 容器中的数据库在此示例中,PostgreSQL 数据库运行在 Docker 容器中,并且无法直接访问。 必须通过运行在另一个 Docker 容器中的跳板主机建立连接。 您需要使用加密的私钥文件进行身份验证。 要创建数据源并运行数据库的测试连接,请执行以下操作:
在 数据库资源管理器 (⌘ 1 )中,点击工具栏上的 新建 ,并导航到 数据源 | PostgreSQL。
点击 SSH/SSL 选项卡并选中 使用 SSH 隧道 复选框。
点击 添加 SSH 配置。
在 SSH 配置 对话框中,通过以下操作添加新配置:
点击 Add 按钮。
在 主机 和 端口 字段中,指定运行在 Docker 容器中的跳板主机的连接详细信息。 例如, localhost 和 2222。
在 用户名 字段中输入您的用户名。
在本教程中,我们使用加密的私钥文件和公钥文件进行身份验证。 从 认证类型 列表中选择 密钥对。
要提供您的私钥文件,请点击 浏览 ,在 私钥文件 字段中选择文件。
对于此身份验证类型,请确保您的公钥文件已提供并存储在跳板主机上。
在 密码短语 字段中指定您的密码短语。
点击 测试连接 以运行跳板主机的测试连接。
在 SSH 配置 对话框中,点击 确定 以确认新的 SSH 配置设置。
在 通用 选项卡的 数据源与驱动程序 对话框中,指定您的数据库连接详细信息:
在 主机 和 端口 字段中,指定您的数据库服务器地址和端口号。 例如, 172.19.0.3 和 5432。 对于基于文件的数据库,在相应字段中指定数据库文件的路径。
从 身份验证 下拉列表中选择 用户&密码。
在 User 和 密码 字段中,输入您的用户凭证。
在 数据库 字段中,输入您想要连接的数据库名称。 在我们的示例中, guest。
在 URL 字段中,DataGrip使用其他连接设置的值自动生成JDBC URL。
如果您需要使用包含某些附加设置的 JDBC URL,请将其粘贴到 URL 字段中。
例如, jdbc:postgresql://172.19.0.3:5432/guest。
点击连接详细信息区域底部的 测试连接 链接以启动到数据库的测试连接。
请点击 确定 以创建数据源。
2026年 3月 24日配置 SSH 和 SSLJDBC 驱动程序