DataGrip 2026.3 Help

Docker 连接设置

指定从 DataGrip 访问 Docker Engine API 的设置。 有关使用 Docker 集成 DataGrip 的更多信息,请参阅 Docker。

启用 Docker 插件

此功能依赖于 Docker 插件,该插件在 DataGrip 中默认捆绑并启用。 如果相关功能不可用,请确保您未禁用该插件。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 Plugins。

  2. 找到 Docker 插件并点击 启用。

Docker 连接设置

您可以指定 DataGrip 用于与 Docker 守护进程交互的 Docker CLI 可执行文件的路径。

DataGrip 应该能够自动检测到默认安装位置的 Docker CLI 可执行文件。 但是,如果您在自定义位置安装了 Docker,您可能需要手动指定路径。 如果未安装 Docker CLI,可以 直接从 DataGrip 下载。

Docker 可执行文件

指定 Docker CLI 可执行文件的基本路径。 默认位置:

macOS 和 Linux

/usr/local/bin/docker

Windows

C:\Program Files\Docker\Docker\resources\bin\docker.exe

Docker Compose 可执行文件

指定 Docker Compose 独立可执行文件的路径。 默认情况下,Compose V2 集成到 Docker CLI 平台中,并通过 docker compose 命令使用相同的可执行文件进行 Docker Compose。

如果您使用的是 Compose V1,主要的 Docker 可执行文件将无法用于 Docker Compose。 在这种情况下,您需要指定 docker-compose 的路径。 欲了解更多信息,请参见 docker-compose vs docker compose。

您可以添加多个 Docker 配置,每个配置代表与单独的 Docker 守护进程的连接:

"添加"按钮Docker

添加新的 Docker 配置。

"移除"按钮删除 Alt+Delete

删除所选的 Docker 配置。

对于每个 Docker 配置,请指定一个名称,并根据操作系统选择连接类型:

适用于 Windows 的 Docker

当您在 Windows 上使用 Docker Desktop时,这是推荐的选项。

适用于 Mac 的 Docker

这是在 macOS 上使用 Docker Desktop 时的推荐选项。

Unix 套接字

在 Linux 上使用 Docker Desktop 时,这是推荐的选项。

TCP 套接字

手动配置 Docker Engine API 的 URL。

在 引擎 API URL 字段中,您可以指定到远程 Docker 守护进程的 TCP 连接或任何 Docker 套接字路径,包括自定义本地套接字。 例如,在 rootless mode ,Docker daemon 通过具有唯一标识符的 systemd 用户服务运行,因此 socket path 将类似于 unix:///run/user/1000/docker.sock。

默认情况下,在 macOS 和 Linux 上,Docker 守护程序会在 Unix 套接字 unix:///var/run/docker.sock 上监听 Docker Engine API 请求。

如果您使用 Docker Desktop for Windows,您可以通过命名管道在 npipe:////./pipe/docker_engine 或 TCP 套接字在 tcp://localhost:2375 连接到 Docker Engine。

您还可以连接到 Podman ,其 API 等同于 Docker Engine API。 更多信息请参阅 Podman。

SSH

通过现有的 SSH 配置 连接到远程 Docker daemon 或创建一个新的连接。

WSL

连接到在 Windows Subsystem for Linux (WSL) 中运行的 Docker 守护进程。

Minikube​

如果您正在运行 minikube ,请选择此选项以自动检测并连接到 minikube 的 Docker Engine 环境。

如果 DataGrip 无法检测到 minikube 或者它在远程运行,请运行 minikube docker-env 命令以获取必要的连接信息,并在 TCP socket 下设置以下内容:

  • 引擎 API URL: DOCKER_HOST 的值(使用 https 作为协议而不是 tcp)

  • 证书文件夹: DOCKER_CERT_PATH 的值

从 IDE 下载 Docker CLI

DataGrip 需要本地 Docker CLI 来构建镜像并运行 Docker Compose,包括连接到远程 Docker Engine 时。

如果 DataGrip 在计算机上找不到 Docker CLI,IDE 会显示 Docker CLI 未安装 通知,其中包含下载选项。 同一警告也会显示在 Docker 设置页面的顶部。

DataGrip 会下载 Docker 提供的以下工具:

  • Docker 命令行界面 29.6.2

  • Docker Buildx 0.35.0

  • Docker Compose 5.3.1

下载的工具不包括 Docker Engine。 要运行容器,请连接到远程 Docker Engine,或在计算机上安装 Docker Engine。

下载的工具存储在 docker-cli 目录中:

macOS

~/Library/Application Support/JetBrains/docker-cli

Windows

%APPDATA%\JetBrains\docker-cli

Linux

~/.local/share/JetBrains/docker-cli

Windows 和 macOS 主机的虚拟机路径映射

Docker 引擎在 Linux 上本地运行。 在 Windows 和 macOS 上,Docker 在一个轻量级的 Linux 虚拟机中运行,因此容器只能访问存在于该虚拟机内的文件。

请使用 Docker 连接配置选项下方的表格来配置本地文件系统和运行 Docker 引擎的虚拟机之间的映射,使其能够在容器中作为卷挂载进行访问。

"添加"按钮Add Alt+Insert

添加新的映射。

"移除"按钮移除 Ctrl+Y

删除所选映射。

Edit 按钮编辑 Enter

编辑所选映射。

虚拟机路径

用于运行此 Docker Engine 的虚拟机中目录的路径。

本地路径

您要映射到虚拟机中相应目录的本地文件夹路径。 您将无法将此文件夹外的任何内容绑定到此 Docker Engine 运行的容器上。

DataGrip 仅在 Windows 和 macOS 主机上应用这些映射。 默认情况下,该表在 Windows 上将 C:\Users 映射到 /c/Users ,在 macOS 上将 /Users 映射到 /Users 。 在 服务 工具窗口中为容器配置绑定挂载时,主机路径的文件选择器仅显示此表中的本地文件夹,DataGrip 会将本地路径替换为对应的虚拟机路径。 如果该表为空,DataGrip 会要求您先在 Docker 设置中配置路径映射。

添加路径映射

如果需要从现有映射未涵盖的本地文件夹绑定挂载文件,请添加映射。

  1. 在 Docker 连接选项下方的表中,点击 "添加"按钮 (Alt+Insert)。

  2. 在 虚拟机路径 字段中,指定运行 Docker Engine 的虚拟机可看到该文件夹所在的路径。

  3. 在 本地路径 字段中,指定本地文件夹。

  4. 应用更改并关闭对话框。

假设您将所有绑定挂载到 Docker 容器的文件都保存在 /Users/jsmith/docker-share 中。 您可以将此目录映射到虚拟机上的 /dockerShare 以进行 Docker Engine 连接。 此 Docker Engine 会从 /dockerShare 将文件绑定挂载到容器,因为它可以在此处访问从 /Users/jsmith/docker-share 映射的文件。

这不会对您作为运行容器的用户产生影响,因为您仍然可以配置绑定挂载和卷,作为主机机器上的某些路径与容器内部某些路径之间的映射。 但是,您无法挂载位于已映射到虚拟机的目录之外的任何内容。

假设您运行一个容器,并将主机上包含应用程序制品的目录 /Users/jsmith/docker-share/out 挂载到容器中的 /usr/local/tomcat/webapps 。 在这种情况下,Docker Engine 实际挂载 /dockerShare/out ,因为它可通过虚拟机映射在此处访问您的文件。

虚拟机运行 Docker Engine 的路径映射

有关卷和绑定挂载的更多信息,请参阅 在 Docker 中管理数据。

2026年 11月 7日