# Docker 连接设置

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> `文件 | 设置 | 构建、执行与部署 | Docker`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 构建、执行与部署 | Docker`  适用于 macOS
>
>
>
> `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)) !["设置"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)

指定从 IntelliJ IDEA 访问 Docker Engine API 的设置。 有关使用 Docker 集成 IntelliJ IDEA 的更多信息，请参阅 [Docker](docker.html)。

Procedure: 启用 Docker 插件

此功能依赖于 [Docker](https://plugins.jetbrains.com/plugin/7724-docker) 插件，该插件在 IntelliJ IDEA 中默认捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

> **Note:**
> Docker 插件默认仅在具有 Ultimate 订阅的 IntelliJ IDEA 中可用。 对于 IntelliJ IDEA，您需要按照 [插件](managing-plugins.html) 中的说明安装 Docker 插件。

1. 按 `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)) 打开设置，然后选择  `插件` 。

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

![Docker 连接设置页面](https://resources.jetbrains.com/help/img/idea/2026.3/docker_configuration_settings.png)

可以指定 IntelliJ IDEA 用于与 Docker 守护进程交互的 [Docker CLI](https://docs.docker.com/engine/reference/commandline/cli/) 可执行文件的路径。

IntelliJ IDEA 应该能够自动检测到默认安装位置的 Docker CLI 可执行文件。 但是，如果您在自定义位置安装了 Docker，您可能需要手动指定路径。

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](https://docs.docker.com/compose/migrate/#docker-compose-vs-docker-compose)。

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

!["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)   Docker
: 添加新的 Docker 配置。

!["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)   删除   `Alt+Delete` (Windows), `Alt+Delete` (macOS), `Alt+Delete` (IntelliJ IDEA Classic (macOS)), `Alt+Delete` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `Alt+Delete` (Sublime Text (macOS)), `Alt+Delete` (Visual Studio), `Alt+Delete` (Visual Studio (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))
: 删除所选的 Docker 配置。

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

Docker 适用于 Windows
: 当您在 Windows 上使用 [Docker Desktop](https://www.docker.com/products/docker-desktop/)时，这是推荐的选项。

Docker 适用于 Mac
: 这是在 macOS 上使用 [Docker Desktop](https://www.docker.com/products/docker-desktop/) 时的推荐选项。

Unix Socket
: 在 Linux 上使用 [Docker Desktop](https://www.docker.com/products/docker-desktop/) 时，这是推荐的选项。

TCP 套接字
: 手动配置 [Docker Engine API](https://docs.docker.com/engine/api/) 的 URL。
:
:
:
: 在   引擎 API URL   字段中，您可以指定到远程 Docker 守护进程的 TCP 连接或任何 Docker 套接字路径，包括自定义本地套接字。 例如，在 [rootless mode](https://docs.docker.com/engine/security/rootless/)，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](https://www.docker.com/products/docker-desktop/) for Windows，您可以通过命名管道在  `npipe:////./pipe/docker_engine`  或 TCP 套接字在  `tcp://localhost:2375`  连接到 Docker Engine。
:
:
:
: 您还可以连接到 [Podman](https://podman.io/)，其 API 等同于 Docker Engine API。 更多信息请参阅 [Podman](podman.html)。
:
:
:
: > **Note:**
: > 由于   证书文件夹   字段指定了任何包含证书的文件夹，此字段对应于  `DOCKER_CERT_PATH`  环境变量。 有关更多信息，请参阅 Docker 文档中的 [Client modes](https://docs.docker.com/engine/security/https/#client-modes)。

SSH
: 通过现有的 [SSH 配置](settings-tools-ssh-configurations.html) 连接到远程 Docker daemon 或创建一个新的连接。
:
:
:
: > **Note:**
: > 通过 SSH 连接到 Docker 守护程序仅在 IntelliJ IDEA Ultimate 中受支持。 此功能在 IntelliJ IDEA Community Edition 中不可用。

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

Minikube},{
: 如果您正在运行 [minikube](https://minikube.sigs.k8s.io/docs/start/)，请选择此选项以自动检测并连接到 minikube 的 Docker Engine 环境。
:
:
:
: 如果 IntelliJ IDEA 无法检测到 minikube 或者它在远程运行，请运行  `minikube docker-env`  命令以获取必要的连接信息，并在 [TCP socket](#tcp_socket) 下设置以下内容：
:
:
:
: * 引擎 API URL ： `DOCKER_HOST` 的值（使用 `https` 作为协议而不是 `tcp` ）
:
: * 证书文件夹 ： `DOCKER_CERT_PATH` 的值

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

Docker 引擎在 Linux 上原生运行。 在 Windows 和 macOS 上，Docker 在轻量级 Linux 虚拟机中执行，因此容器只能访问该虚拟机内存在的文件。

Docker 连接配置选项下方的表格可用于配置本地文件系统与运行 Docker 引擎的虚拟机之间的映射，使其可用于容器中的卷挂载。

!["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)   添加   `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))
: 添加新的映射。

!["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)   移除   `Ctrl+Y` (Windows), `⌘ ⌫` (macOS), `⌘ Y` (IntelliJ IDEA Classic (macOS)), `⌘ ⌫` (macOS System Shortcuts), `Ctrl+Y` (XWin), `Ctrl+Y` (GNOME), `Ctrl+Y` (KDE), `Ctrl+Y` (Emacs), `Ctrl+Shift+K` (Sublime Text), `⌃ ⇧ K` (Sublime Text (macOS)), `Ctrl+L` (Visual Studio), `⌘ ⇧ L` (Visual Studio (macOS)), `Ctrl+E` (NetBeans), `Ctrl+D` (Eclipse), `⌘ D` (Eclipse (macOS))
: 删除所选映射。

![编辑按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inline_edit.svg)   编辑   `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))
: 编辑所选映射。

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

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

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

Procedure: 添加路径映射

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

1. 在 Docker 连接选项下方的表中，点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) ( `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)))。

2. 在   虚拟机路径   字段中，指定运行 Docker 引擎的虚拟机看到该文件夹时所用的路径。

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

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

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

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

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

![虚拟机运行 Docker Engine 的路径映射](https://resources.jetbrains.com/help/img/idea/2026.3/docker_path_mappings_for_vm.png)

有关卷和绑定挂载的更多信息，请参阅 [在 Docker 中管理数据](https://docs.docker.com/storage/)。

## See also

### 相关

[Docker](docker.html)

### 参考

[Docker Registry 设置](settings-docker-registry.html) [Docker 控制台设置](settings-docker-console.html) [“服务”工具窗口](services-tool-window.html)