# 无法连接到数据库 > For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt). ## 步骤 1。 检查您的网络设置 数据库可以本地工作、在服务器上工作或在云端工作。 对于服务器和云数据库，您需要网络连接。 要验证连接是否可用，请使用 ping 和 telnet 命令。 使用 ping 命令，您可以确保目标计算机可以从源计算机访问。 打开命令行并输入以下命令： `ping -a ` ，其中 `-a` 是一个命令选项，用于将地址解析为主机名（如果可能的话）。 如果您在 ping 命令中使用主机名，则主机名将解析为 IP 地址。 例如， `ping -a example.com` 解析为 `PING example.com (93.184.216.34)` 。 ``` ping -a ``` ![使用 ping 命令测试连接](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_test_connection_with_ping.png) 使用 telnet 命令，您可以测试与远程计算机的连接并发出命令。 如果您将端口作为 `telnet` 命令的参数指定，您可以测试与给定端口上远程主机的连接性。 如果连接成功，您会看到消息： `Connected to ` 。 ``` telnet ``` ![使用 telnet 命令测试连接](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_test_connection_with_telnet.png) > **Note:** > 出于安全原因，DBMS 通常会断开所有 telnet 连接。 telnet 命令允许您检查端口是否已打开以进行通信。 ## 步骤 2。 检查您的连接属性 每个数据库（MySQL、PostgreSQL、甲骨文或任何其他供应商）都有自己的连接设置。 大多数数据库包括以下连接设置： * 主持人 ：存储数据库的计算机或其他设备的主机名。 它可以是一个 IP 地址 `127.0.0.1` 或一个域名 `本地主机` 。 * 数据库 ：您想要连接的数据库名称。 您可以在数据库服务器的设置中找到数据库名称，或者可以询问您的数据库管理员。 在某些情况下，可以在数据库命令行中运行查询以查看所有可用数据库的名称。 例如，在 MySQL 中，可以运行 `SHOW DATABASES;` 。 ![SHOW DATABASES 查询](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_troubleshooting_show_databases.png) * 用户 ：具有足够权限执行数据库操作的用户名称。 在数据库命令行中运行查询以查看所有可用数据库的名称。 例如，在 MySQL 中，可以运行 `SHOW GRANTS;` 。 ![SHOW GRANTS 查询](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_troubleshooting_show_grants.png) * 密码 ：用户的密码。 * 端口 ：用于标识主机之间连接点的编号。 主机使用端口号来确定必须与哪个应用程序、服务或进程建立连接。 不同的数据库供应商为其数据库使用不同的端口。 以下列表是默认端口号列表。 | 供应商 | 默认端口 | | --- | --- | | Amazon Redshift | 5439 | | Apache Derby 数据库 | 1527 | | Apache Cassandra | 9042 | | Apache Hive | 10000（Hive Server2）或 9083（Hive Metastore） | | Azure SQL 数据库 | 1433 | | ClickHouse | 8123 | | Couchbase 查询服务 查询服务 | 11210 | | Exasol | 8563 | | Greenplum | 5432 | | H2 | 8082 | | HSQLDB | 9001 | | IBM Db2 LUW | 50000 | | MariaDB | 3306 | | Microsoft SQL 服务器 | 1433 (TCP)，1434 (UDP可能需要) | | MySQL | 3306 | | 甲骨文 | 1521 | | PostgreSQL | 5432 | | Snowflake | 443 | | SQLite | 无 | | Sybase ASE： | 5000 | | Vertica | 5433 | > **Note:** > 在您的系统上，实际端口号可能会有所不同。 请与您的数据库管理员、服务器设置或托管服务提供商核实您使用的端口号是否正确。 请验证所选数据源的连接设置是否正确。 有关创建和更改数据源的更多信息，请参阅 [创建数据源](managing-data-sources.html#create_a_data_source)和 [会话](managing-connection-sessions.html)。 ## 步骤 3。 检查驱动程序版本 有了 JDBC 驱动程序，您就可以与 IntelliJ IDEA 中的数据库管理系统 (DBMS) 进行交互。 每个 DBMS 需要自己的 JDBC driver。 确保驱动程序版本和 DBMS 版本彼此兼容。 从 IntelliJ IDEA，您可以下载所有受支持厂商的驱动程序。 您可以在 驱动程序 列表中查看支持的供应商完整列表。 或者，您可以将自己的驱动程序添加到现有供应商，或为不在 驱动程序 列表上的供应商创建新的驱动程序条目。 要打开 驱动程序 列表，请在 数据库 工具窗口（ `视图 | 工具窗口 | 数据库` ）中，点击 数据源属性},{ 图标 ![数据源属性图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) 或按 `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS))。 Procedure: 下载驱动程序并选择驱动程序版本 要从 JetBrains FTP 服务器下载驱动程序，请从 驱动程序 列表中选择供应商，并点击 下载版本 链接 驱动文件 窗格中的链接。 要更改驱动程序版本，请点击 版本 链接在 驱动文件 面板中并选择您需要的驱动程序版本。 ![驱动程序列表和驱动程序设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_download_driver_select_driver_version.png) Procedure: 使用用户驱动文件 1. 通过以下任一方式打开数据源属性： * 在 数据库 工具窗口工具栏中，点击 ![数据源图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) 数据源 。 * 请按 `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) . ![打开数据源和驱动程序对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png) 2. 在 数据源和驱动程序 对话框中，确保您位于 驱动程序 选项卡。 3. 在 数据源和驱动程序 对话框中，点击 添加 图标( !["添加"图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg))。 4. 在 名称 字段中，输入驱动程序的名称。 5. 在 驱动程序文件 面板中，点击 添加 图标（ !["添加"图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)）并选择 自定义 JARs… 。 6. 请导航到 JDBC 驱动程序的 JAR 文件，选择它，并点击 OK 。 7. 在 类 字段中，指定您想要用于驱动程序的值。 8. 点击 应用 。 9. 要从驱动程序对话框中创建数据源，请点击 创建数据源 。 [Video](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_create_user_driver_connection.mp4) Procedure: 为现有数据源配置 JDBC 驱动程序 您可以向现有驱动程序添加库，或完全替换驱动程序。 为了正常工作，一些 JDBC 驱动程序需要与驱动程序一同提供库文件的路径。 有关库路径的更多信息，请参阅 [用户驱动程序的库路径](other-databases.html#library-paths-for-user-drivers)。 1. 通过以下任一方式打开数据源属性： * 在 数据库 工具窗口工具栏中，点击 ![数据源图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) 数据源 。 * 请按 `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) . ![打开数据源和驱动程序对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png) 2. 点击数据源设置中的 驱动程序 链接并选择 前往 Driver 。 3. 点击所提供的驱动程序条目，然后点击 移除 （ !["移除"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.remove.svg)）。 要撤销更改，点击窗口右下角的 回滚更改 图标（ !["回滚更改"图标 ](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.diff.revert.svg)）。 4. 在 驱动程序文件 面板中，点击 添加 图标（ !["添加"图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)）并选择 自定义 JARs… 。 5. 在文件浏览器中，导航到 JDBC 驱动的 JAR 文件，选择它，然后点击 OK 。 6. 在 类 字段中，指定您想要用于驱动程序的值。 驱动程序类 是 JDBC 驱动程序的驱动程序特定主类。 对于您使用的 JDBC 驱动程序的适当驱动程序类，请参考驱动程序的文档。 > **Note:** > 如果该字段为空，或者预定义值与驱动程序所需的值不同，请手动指定所需值。 7. 如果您的自定义驱动程序需要额外的属性，请转到对话框中的 高级 选项卡。 在属性窗格中，在 名称 和 值 列的最后一行中输入附加属性的名称和值，其中显示 <用户定义> 和 <值>。 8. 点击 应用 。 > **Tip:** > 有关 JDBC 驱动程序设置的更多信息，请参阅 [对话框参考主题](data-sources-and-drivers-dialog.html#driver)。 [Video](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_add_user_driver_to_connection.mp4) ## 步骤 4。 （仅限 Windows）检查临时目录路径是否包含非 ASCII 字符 目前，临时目录路径不应包含非 ASCII 字符。 如果包含，您可以通过以下方法之一解决问题： * 打开 Windows 控制面板并导航到 `设置 | 时间与语言 | 语言 | 管理语言设置` 或 Windows 10 的 `设置 | 时间和语言 | 语言和区域 | 管理语言设置` 。 在 非 Unicode 程序的语言 部分，将语言更改为您的本地语言。 * 为了让 Java 使用仅包含 ASCII 字符的另一个临时目录路径，请在 IDE 中转到 `帮助 | 编辑自定义 VM 选项` 并将 `-Djava.io.tmpdir=` 添加到 `idea.vmoptions` 文件中。 ## 步骤 5。 检查是否需要使用 SSH 或 SSL 连接 为使与数据库的连接更安全，某些服务要求使用 SSH 或 SSL。 ### SSL 以下过程介绍适用于大多数数据库的 SSL 配置。 对于某些数据库，需要使用其他方法才能成功连接。 可以在 DataGrip 文档中查看 [Cassandra](https://www.jetbrains.com.cn/help/datagrip/how-to-connect-to-cassandra-with-ssl.html) 和 [Heroku Postgres](https://www.jetbrains.com.cn/help/datagrip/how-to-connect-to-heroku-postgres.html) 的配置示例。 Procedure: 连接到支持 SSL 的数据库 1. 通过以下任一方式打开数据源属性： * 在 数据库 工具窗口工具栏中，点击 ![数据源图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) 数据源 。 * 请按 `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) . ![打开数据源和驱动程序对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png) 2. 在 数据源 选项卡上，选择要修改的数据源。 3. 点击 SSH/SSL 选项卡并选中 使用 SSL 复选框。 4. 在 CA 文件 字段中，导航到 CA 证书文件（例如， `mssql.pem` ）。 5. 可以将证书文件字段留空，并使用信任库从其包含的证书中获取所需证书。 为此，请勾选 使用信任存储 复选框，并选择要使用的信任库。 * IDE ：使用 IDE 接受的证书。 可以在 `设置 | 外观＆行为 | 系统设置 | 服务器证书` 中添加新的已接受证书。 * JAVA ：使用 JAVA 信任库证书。 * 系统 ：使用系统信任库证书。 6. 在 客户端证书文件 字段中，导航到客户端证书文件（例如， `client-cert.pem` ）。 7. 在 客户端密钥文件c 字段中，导航到客户端密钥文件（例如， `client-key.pem` ）。 8. 从 模式 列表中选择验证模式： | | | | --- | --- | | 需要 | 如果提供了证书，则验证服务器是否识别客户端证书。 | | 验证 CA | * 如果提供了证书，则验证服务器是否识别客户端证书。 * 通过检查证书链直至存储在客户端的根证书来验证服务器。 | | 完全验证 | * 如果提供了证书，则验证服务器是否识别客户端证书。 * 通过检查证书链直至存储在客户端的根证书来验证服务器。 * 验证服务器主机以确保其与存储在服务器证书中的名称匹配。 | 如果任一证书无法验证，SSL 连接将失败。 9. 要确保与数据源的连接成功，请点击 测试连接 。 ![连接到支持 SSL 的数据库](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_connect_with_ssl.png) > **Note:** > 建议使用 PEM 证书。 > **Note:** > 使用自签名证书时，以及在某些情况下使用由受信任根实体签发的证书时，使用最新的 JDBC 驱动程序版本可能会遇到错误。 如果您的 Java 密钥存储 不接受证书链，SSL 连接可能会失败。 作为临时解决方案，请尝试降级 JDBC 驱动程序（例如，对于 MySQL 连接器，需要切换到 5.1.40 版本）。 Procedure: 禁用与数据库的 SSL 连接 1. 通过以下任一方式打开数据源属性： * 在 数据库 工具窗口工具栏中，点击 ![数据源图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) 数据源 。 * 请按 `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) . ![打开数据源和驱动程序对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png) 2. 在 数据源 选项卡上，选择要修改的数据源。 3. 点击 SSH/SSL 选项卡，并清除 使用 SSL 复选框。 4. 点击 应用 。 Procedure: 从其他数据源复制 SSL 设置 如果已为一个数据源配置了 SSL 设置，可以将其复制到另一个数据源。 1. 通过以下任一方式打开数据源属性： * 在 数据库 工具窗口工具栏中，点击 ![数据源图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) 数据源 。 * 请按 `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) . ![打开数据源和驱动程序对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png) 2. 在 数据源 选项卡上，选择要修改的数据源。 3. 点击 SSH/SSL 选项卡并选中 使用 SSL 复选框。 4. 点击 复制自… 链接并选择您想要复制的配置。 ### SSH Secure Shell（SSH）是一种用于加密客户端与服务器之间连接的网络协议。 在 IntelliJ IDEA 中，可以通过以下方式之一创建 SSH 连接： * [使用 IntelliJ IDEA SSH 隧道。](#ssh_tunnel) IDE 将使用您设置的 SSH 配置创建 SSH 隧道。 * [使用 PuTTy、Pageant 或 ssh-client 手动创建 SSH 隧道。](#ssh_tunnel_manually) #### IntelliJ IDEA SSH 隧道 IntelliJ IDEA 可以基于您设置的 SSH 配置创建 SSH 隧道。 要访问 SSH 配置设置，请按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置并选择 工具 | SSH 配置 。 要为数据源使用 SSH 隧道，请在 数据源和驱动程序 对话框（ `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS))）的 SSH/SSL 选项卡中选中 使用 SSH 隧道 复选框。 > **Note:** > 在大多数情况下，在 SSH/SSL 选项卡中设置 SSH 配置后，无需修改 常规 选项卡的设置，因为 IntelliJ IDEA 将连接到 SSH 隧道的本地端。 例外情况是手动创建 SSH 隧道时。 在这种情况下，需要在 常规 选项卡上将 主持人 设置为隔离网络中服务器的 IP 地址。 > > > > 建立连接后，SSH 隧道主机名会在运行 SSH 服务器的机器上进行解析，因为由该服务器与数据库建立连接。 所有已创建的 SSH 连接会在项目中的所有数据源之间共享。 如果不希望在项目之间共享连接，请在 SSH 连接设置中选中 仅对该项目可见 复选框。 Procedure: 使用 SSH 连接到数据库 1. 通过以下任一方式打开数据源属性： * 在 数据库 工具窗口工具栏中，点击 ![数据源图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) 数据源 。 * 请按 `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) . ![打开数据源和驱动程序对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png) 2. 选择要为其设置 SSH 连接的数据源。 3. 点击 SSH/SSL 选项卡并选中 使用 SSH 隧道 复选框。 4. 点击 ![添加 SSH 配置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.general.ellipsis.svg) 添加 SSH 配置 。 5. 在 SSH 配置 对话框中，点击 添加 按钮。 6. 如果您不想在项目之间共享配置，请选择 仅对该项目可见 复选框。 7. 在 主持人 和 端口 字段中，指定连接详细信息。 8. 在 用户名 字段中输入用户名。 9. 本教程使用加密的私钥文件和公钥文件进行身份验证。 在 身份验证类型 列表中，可以选择一种身份验证方法： * 密码 ：使用密码访问主机。 要将密码保存在 IntelliJ IDEA 中，请选中 保存密码 复选框。 * 密钥对（OpenSSH 或 PuTTY） ：使用 [SSH 认证](https://www.ssh.com/)与密钥对。 要应用此身份验证方法，您必须在客户端计算机上拥有私钥，并在远程服务器上拥有公钥。 IntelliJ IDEA 支持使用 [OpenSSH](https://www.openssh.com/) 工具生成的私钥。 指定存储您 私钥 的文件路径，并在相应字段中输入密码短语（如果有）。 要让 IntelliJ IDEA 记住该密码短语，请选中 保存密码短语 复选框。 * OpenSSH 配置和身份验证代理 ：使用管理您的 SSH 密钥的凭据助手应用程序，例如 [ssh-agent](https://en.wikipedia.org/wiki/Ssh-agent) 或 [Pageant（仅限 Windows）](https://the.earth.li/~sgtatham/putty/0.70/htmldoc/Chapter9.html#pageant)。 > **Tip:** > 如果您同时运行了 OpenSSH ssh-agent 和 Pageant，即使 ssh-agent 中没有任何密钥，也只会使用 ssh-agent。 10. 点击 测试连接 以运行测试连接。 11. 在 SSH 配置 对话框中，点击 OK 以确认新的 SSH 配置设置。 12. 在 数据源和驱动程序 对话框的 本地端口 字段中，指定要用于转发连接的本地端口号。 否则，IntelliJ IDEA 会动态选择端口。 13. 点击连接详细信息区域底部的 测试连接 链接，以启动与数据库的测试连接。 ![测试连接链接](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_test_connection_link.png) 14. 点击 OK 创建数据源。 ![数据源的 SSH 设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_ssh_configurations.png) > **Tip:** > 有关使用 SSH 密钥的更多信息，请参阅 [生成新的 SSH 密钥并将其添加到 ssh-agent](https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/) 教程。 ##### 示例 有关使用 SSH 连接到数据库的示例，请参阅 [使用 SSH 连接到数据库](connect-to-a-database-with-ssh.html) 主题。 Procedure: 禁用 SSH 连接到数据库 1. 通过以下任一方式打开数据源属性： * 在 数据库 工具窗口工具栏中，点击 ![数据源图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg) 数据源 。 * 请按 `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) . ![打开数据源和驱动程序对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/open_data_sources_and_drivers_dialog.png) 2. 选择要更改连接设置的数据源配置文件。 3. 点击 SSH/SSL 选项卡，并清除 使用 SSH 隧道 复选框。 4. 点击 应用 。 #### 手动创建 SSH tunnel Procedure: 使用 PuTTY 创建 SSH 隧道（Windows） 1. 下载并运行最新版本的 PuTTY SSH 和 Telnet 客户端（从 [https://www.putty.org/](https://www.putty.org/) 下载客户端）。 2. 在 PuTTY 配置 对话框中，导航到 `连接 | SSH | 身份验证` 。 3. 在 用于身份验证的私钥文件 字段中，指定私钥文件的路径，然后点击 打开 。 4. 在命令行窗口中，指定用于 SSH 隧道的用户名，然后按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。 请勿关闭命令行窗口。 5. 在 数据库 工具窗口中，点击工具栏上的 数据源属性},{ 图标 ![数据源属性图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg)。 6. 选择要更改连接设置的数据源配置文件。 7. 点击 SSH/SSL 选项卡并选中 使用 SSH 隧道 复选框。 8. 从 身份验证类型 列表中选择 OpenSSH 配置和身份验证代理 。 9. 在 代理主机 、 代理用户 和 端口 字段中，指定连接详细信息。 10. 要确保与数据源的连接成功，请点击 测试连接 。 ![使用 PuTTY 创建 SSH 隧道（Windows）](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_putty_key_config.png) Procedure: 使用 Pageant 创建 SSH 隧道（Windows） Pageant 是用于 PuTTY、PSCP、PSFTP 和 Plink 的 SSH 身份验证代理。 Pageant 会存储私钥，只要它在运行，就会向 PuTTY 或类似 IntelliJ IDEA 的其他工具提供已解锁的私钥。 您可以在 Windows 任务栏中找到 Pageant 图标。 1. 下载最新版本的 Pageant（从 [https://www.putty.org/](https://www.putty.org/) 下载客户端）。 2. 在 Windows 任务栏中，右键点击 Pageant 图标，并选择 添加密钥 。 3. 在 选择私钥文件 对话框中，导航到私钥文件（PPK 文件），然后点击 打开 。 4. （可选）输入私钥密码短语，然后按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。 5. 在 数据库 工具窗口中，点击工具栏上的 数据源属性},{ 图标 ![数据源属性图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg)。 6. 选择要更改连接设置的数据源配置文件。 7. 点击 SSH/SSL 选项卡并选中 使用 SSH 隧道 复选框。 8. 从 身份验证类型 列表中选择 OpenSSH 配置和身份验证代理 。 9. 在 代理主机 、 代理用户 和 端口 字段中，指定连接详细信息。 10. 要确保与数据源的连接成功，请点击 测试连接 。 ![使用 Pageant 创建 SSH 隧道（Windows）](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_task_area_pageant.png) Procedure: 使用 ssh-agent 创建 SSH 隧道（macOS 和 Linux） 在命令行中运行所有 ssh-agent 命令。 1. 确保 ssh-agent 正在运行。 ``` ssh-agent ``` 2. 将密钥添加到代理中（在以下示例中，密钥路径为 `~/.ssh/id_rsa` ）。 ``` ssh-add ~/.ssh/id_rsa ``` 3. （可选）在 macOS 上，可以在 `ssh-add` 命令中添加 `-K` 选项，以将密码短语存储在钥匙串中。 在 macOS Sierra 及更高版本上，需要在 `~/.ssh/` 中创建 `config` 文件，并包含以下文本： ``` Host * UseKeychain yes AddKeysToAgent yes IdentityFile ~/.ssh/id_rsa ``` 如果 `.ssh` 目录中还有其他私钥，请为每个密钥添加一行 `IdentityFile` 。 例如，如果第二个密钥的名称为 `id_ed25519` ，请为第二个私钥另加一行 `IdentityFile ~/.ssh/id_ed25519` 。 4. 列出所有已添加的密钥。 ``` ssh-add -L ``` 5. 在 数据库 工具窗口中，点击工具栏上的 数据源属性},{ 图标 ![数据源属性图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/database-plugin.icons.expui.manageDataSources.svg)。 6. 选择要更改连接设置的数据源配置文件。 7. 点击 SSH/SSL 选项卡并选中 使用 SSH 隧道 复选框。 8. 从 身份验证类型 列表中选择 OpenSSH 配置和身份验证代理 。 9. 在 代理主机 、 代理用户 和 端口 字段中，指定连接详细信息。 10. 要确保与数据源的连接成功，请点击 测试连接 。 ![使用 ssh-agent 创建 SSH 隧道（macOS 和 Linux）](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_ssh_agent_linux_macos.png) ## 步骤 6。 如果您仍然需要帮助，请联系我们 Procedure: 联系 IntelliJ IDEA 团队 * 请发送电子邮件至 [idea-support@jetbrains.com](mailto:idea-support@jetbrains.com)。 请描述您的问题，并附上所有可用的 [可加快故障排查的材料](troubleshooting-materials.html)（代码示例、屏幕截图、日志、动画、视频以及其他材料）。 如需了解更多其他故障排除资源的信息，请参阅 [支持与帮助](getting-help.html)。 ## 本地数据库 如果数据库与 IntelliJ IDEA 在同一台计算机上运行，请执行以下操作： Procedure: 1. 请确保数据库服务器已安装并正在运行。 2. 检查数据库是否接受 TCP/IP 连接。 3. 在 数据源和驱动程序 对话框中（ `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) ）： 1. 在 主持人 字段中指定 `本地主机` 或 `127.0.0.1` 。 2. 确保 端口 字段中指定的端口与为数据库服务器配置的端口匹配。 3. 验证用户名称、密码和其他连接设置是否正确。 4. 请确保已下载正确的 [JDBC 驱动程序](jdbc-drivers.html)，并在 驱动程序 下拉菜单中将其选中。 ## WSL 中的数据源​。 如果数据库在 WSL，请打开 数据源和驱动程序 对话框（ `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS))），并确保 环境 字段设置为 开发容器 。 ![WSL 中数据源的 Environment 数据源设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_data_source_in_wsl_environment_setting.png)