使用 SSH 连接到数据库
本主题提供了如何通过 SSH 隧道和跳板机连接运行在隔离网络中的数据库的示例。
有关如何在 WebStorm 中使用 SSH 的更多信息,请参阅 SSH 与 SSL主题。
云数据库
我们来看以下示例。 MySQL 数据库在云端远程运行,需要通过跳板机建立连接。 您需要使用加密的私钥文件进行身份验证。 要创建数据源并测试连接到数据库,请执行以下操作:
在 数据库 工具窗口中,点击工具栏上的
新建 ,并导航至 。
点击 SSH/SSL 选项卡并选中 使用SSH 隧道(H) 复选框。
点击
添加SSH 配置。
在 SSH 配置 对话框中,执行以下操作添加新配置:
在 常规 选项卡中的 数据源和驱动程序 对话框中,指定数据库连接详情:
在 主机 和 端口 字段中,指定数据库服务器地址和端口号。 例如:
mysql-ssh.my-account.my-region.amazonaws.com和3306。从 身份验证 下拉列表中选择 用户与密码。
在 用户 和 密码 字段中输入您的用户凭据。
在 数据库 字段中输入要连接的数据库名称。 在本示例中为
testdb。在 URL 字段中,WebStorm 会使用其他连接设置中的值自动生成 JDBC URL。
如果需要使用带有特定附加设置的 JDBC URL,请将其粘贴到 URL 字段中。
例如:
jdbc:mysql://my-endpoint.amazonaws.com:3306/testdb。
点击连接详情区域底部的 测试连接 链接以测试连接数据库。

点击 确定 以创建数据源。
![MySQL [Cloud, SSH] 数据源的连接设置 MySQL [Cloud, SSH] 数据源的连接设置](https://resources.jetbrains.com.cn/help/img/idea/2025.2/db_ssh_connection_example_data_source_cloud.png)
Docker 容器中的数据库
在此示例中,PostgreSQL 数据库运行在 Docker 容器中,无法直接访问。 连接必须通过另一个 Docker 容器中运行的跳板机建立。 您需要使用加密的私钥文件进行身份验证。 要创建数据源并测试连接到数据库,请执行以下操作:
在 数据库 工具窗口中,点击工具栏上的
新建 并导航至 。
单击 SSH/SSL 选项卡并选中 使用SSH 隧道(H) 复选框。
单击
添加SSH 配置。
在 SSH 配置 对话框中,通过执行以下操作添加新配置:
在 常规 选项卡的 数据源和驱动程序 对话框中,指定您的数据库连接详细信息:
在 主机 和 端口 字段中,指定您的数据库服务器地址和端口号。 例如,
172.19.0.3和5432。在 身份验证 下拉列表中,选择 用户与密码。
在 用户 和 密码 字段中,输入您的用户凭据。
在 数据库 字段中,输入您要连接的数据库名称。 在我们的示例中,
guest。在 URL 字段中,WebStorm 会使用其他连接设置的值自动生成 JDBC URL。
如果您需要使用包含某些附加设置的 JDBC URL,请将其粘贴到 URL 字段中。
例如,
jdbc:postgresql://172.19.0.3:5432/guest。
单击连接详细信息区域底部的 测试连接 链接,以启动与数据库的测试连接。

单击 确定 以创建数据源。
![MySQL [Cloud, SSH] 数据源的连接设置 MySQL [Cloud, SSH] 数据源的连接设置](https://resources.jetbrains.com.cn/help/img/idea/2025.2/db_ssh_connection_example_data_source_docker.png)

