# Docker 插件集成

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

[Docker](https://www.docker.com/what-docker) 是一种用于在隔离且可复现的环境中部署和运行可执行文件的工具。 例如，这可能对在与生产相同的环境中测试代码有用。

CLion 集成了 Docker 功能，并提供创建 Docker 镜像、运行 Docker 容器、管理 Docker Compose 应用、使用公有和私有 Docker 注册表等更多功能的直接帮助，全部这些都可以直接在 IDE 中完成。

Procedure: 启用 Docker 插件

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

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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  Docker  插件并点击   Enable  。

Procedure: 安装并运行 Docker

* 请按照 [Docker 文档](https://docs.docker.com/install/) 中的说明安装并运行 Docker。

> **Tip:**
> CLion 支持以下替代的 Docker 守护进程： [Colima](https://github.com/abiosoft/colima) 以及 [Rancher Desktop](https://rancherdesktop.io/)（包含  `dockerd`  引擎）。

Procedure: 连接到 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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `构建、执行、部署 | Docker` 。

2. 点击 !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)以添加 Docker 配置，并指定如何连接到 Docker 守护进程。

连接设置取决于您的 Docker 版本和操作系统。 如需更多信息，请参阅 [Docker connection settings](settings-docker.html)。

连接成功  消息应出现在对话框的底部。

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

有关在 Windows 或 macOS 上使用 Docker 时将本地路径映射到运行 Docker 守护进程的虚拟机的更多信息，请参阅 [Windows 和 macOS 主机的虚拟机路径映射](settings-docker.html#virtual-machine-path)。 您将无法对映射本地路径之外的目录使用卷和绑定挂载。

此表在 Linux 主机上不可用，在该主机上 Docker 本地运行，您可以将任何目录挂载到容器。

3. 打开   服务   工具窗口（  `查看 | 工具窗口 | 服务`  或 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `⌘ 8` (Xcode), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (ReSharper), `Alt+8` (ReSharper (macOS)), `Alt+8` (QtCreator), `⌘ 8` (QtCreator (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))），选择已配置的 Docker 连接节点 ![Docker 节点](https://resources.jetbrains.com/help/img/idea/2026.3/clouds-docker-impl.icons.Docker.svg) 并点击 ![“连接”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.execute.svg)，或从上下文菜单中选择   连接  。

![与 Docker 连接的 Docker 工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/51_DockerConnected.png)

要编辑 Docker 连接设置，请选择 Docker 节点并点击工具栏上的 ![“编辑配置”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.edit.svg)，或从上下文菜单中选择   编辑配置  。

您还可以点击 ![添加服务菜单](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 并选择   Docker 连接  ，直接从   服务   工具窗口添加 Docker 连接。 如果您已配置 [Docker contexts](https://docs.docker.com/engine/context/working-with-contexts/)，您可以选择   来自 Docker Contexts 的 Docker 连接   以添加相应的连接。

一旦连接到 Docker daemon，您可以使用   服务   工具窗口 (  `查看 | 工具窗口 | 服务`  或 `Alt+8` (Windows), `⌘ 8` (macOS), `⌘ 8` (IntelliJ IDEA Classic (macOS)), `⌘ 8` (macOS System Shortcuts), `Alt+8` (XWin), `Alt+8` (GNOME), `Alt+8` (KDE), `Alt+8` (Emacs), `Alt+8` (Sublime Text), `⌘ 8` (Sublime Text (macOS)), `⌘ 8` (Xcode), `Alt+8` (Visual Studio), `Alt+8` (Visual Studio (macOS)), `Alt+8` (ReSharper), `Alt+8` (ReSharper (macOS)), `Alt+8` (QtCreator), `⌘ 8` (QtCreator (macOS)), `Alt+8` (NetBeans), `Alt+8` (Eclipse), `⌘ 8` (Eclipse (macOS))) 来管理与 Docker 相关的所有事项，例如： [拉取和推送镜像](docker-images.html)、 [创建和运行容器](docker-containers.html)以及 [扩展 Docker Compose 服务](docker-compose.html)。 与其他工具窗口一样，您可以开始键入图像或容器的名称，以突出显示匹配的项目。

![Docker 工具窗口、文本搜索](https://resources.jetbrains.com/help/img/idea/2026.3/55_DockerFindImage.png)

如需更多信息，请参阅 [服务工具窗口](services-tool-window.html#docker)中的 Docker 部分。

## 使用远程服务器上的 Docker 的先决条件

在 您 开始 在 远程 机器 上 使用 Docker 之前，请确保满足以下前提条件：

* 本地 [Docker CLI](faq-about-dev-containers.html#docker_cli)，这是连接远程 Docker 实例所必需的。 可以安装 Docker Desktop，单独安装 Docker CLI，或 [从 CLion 下载 Docker CLI](settings-docker.html#download-docker-cli)。

* [Docker 构建x](https://github.com/docker/buildx#manual-download) 插件，是从 Dockerfile 构建镜像所必需的。 请注意，使用 构建x 与 Docker 需要 Docker Engine 19.03 或更高版本。 如果从 CLion 下载 Docker CLI，则会包含 Docker Buildx。

> **Note:**
> 对于远程服务器上的 Dev Containers，请参考 [限制](dev-container-limitations.html)。

## See also

### 外部链接

[Watch Docker Toolchain in Action](https://blog.jetbrains.com/clion/2021/12/docker-toolchain/)

### 流程

[Docker toolchain](clion-toolchains-in-docker.html)

