# Docker Compose

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

[Docker Compose](https://docs.docker.com/compose/overview/) 用于运行多容器应用程序。 例如，您可以将一个 Web 服务器、一个后端数据库和您的应用程序代码作为独立的服务运行。 每个服务都可以通过添加更多的容器来扩展规模（如果需要的话）。 这使您能够在类似生产的动态环境中进行高效的开发和测试。

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  。

CLion 能识别 [Docker Compose 文件](https://docs.docker.com/compose/compose-file/)，并用 ![](https://resources.jetbrains.com/help/img/idea/2026.3/clouds-docker-impl.icons.expui.dockerCompose.svg) 图标标记它们。 它还会添加 [边距图标](null)，以运行 Docker Compose 文件中定义的各种服务。

![Docker Compose 文件](https://resources.jetbrains.com/help/img/idea/2026.3/docker_compose_file.png)

CLion 可以按名称或内容检测 Docker Compose 文件。 如果通过内容检测到 Docker Compose 文件，编辑器会在文件顶部显示一个横幅，可在其中选择将其保留为 Docker Compose 或将其从检测中排除。

![Docker Compose 文件检测横幅](https://resources.jetbrains.com/help/img/idea/2026.3/docker-compose-autoconfiguration.png)

Procedure: 对所有 YAML 文件禁用基于内容的检测

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 | Docker Compose` 。

2. 取消选中   按内容检测 Docker Compose 文件   选项并应用更改。

CLion 只会将具有标准名称的文件识别为 Docker Compose 文件：  `compose.yaml` 、  `compose.yml` 、  `compose.override.yaml` 、  `compose.override.yml` ，以及名称包含  `docker-compose`  的 YAML 文件。 标记为   保留为 Docker Compose   的文件仍会被识别。

Procedure: 创建 Docker Compose 文件

1. 在   项目  工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中，右键点击项目根目录，选择   新建  或按 `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)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))，然后选择   Docker Compose 文件},{  。

![创建 docker-compose.yml](https://resources.jetbrains.com/help/img/idea/2026.3/ws_docker_compose_containerize_docker_compose_menu.png)

2. 在弹出窗口中，接受默认的 Docker Compose 文件名称或指定自定义名称，然后按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

![创建 docker-compose.yml](https://resources.jetbrains.com/help/img/idea/2026.3/ws_docker_compose_containerize_docker_compose.png)

Procedure: 完成服务配置

1. 在编辑器中打开 Docker Compose 文件。

2. 开始输入服务名称。 CLion 会显示   服务  弹出窗口，在其中可以选择对应的配置。

![Docker Compose 补全。 选择一个服务](https://resources.jetbrains.com/help/img/idea/2026.3/docker-compose-select-service.png)

> **Tip:**
> 可以使用基础补全快捷键（ `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `⌃ Space` (Xcode), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (ReSharper), `⌃ Space` (ReSharper (macOS)), `Ctrl+Space` (QtCreator), `⌃ Space` (QtCreator (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS))）调出   服务  弹出窗口。
>
>
>
> 要禁用此行为，请前往  `设置 | 构建、执行、部署 | Docker | Docker Compose` 并取消选中   在调用基础补全时显示弹窗  选项。

Procedure: 运行多容器 Docker 应用程序

1. 在一个或多个 [Docker Compose 文件](https://docs.docker.com/compose/compose-file/)中定义必要的服务。

2. 在主菜单中，进入  `运行 | 编辑配置` .

3. 点击 !["添加"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)，指向   Docker  ，然后点击   Docker Compose  。

4. 指定包含您的服务定义的 Docker Compose 文件。 如果必要，您可以定义此配置将启动的服务，指定 [环境变量](https://docs.docker.com/compose/environment-variables/)，并在启动相应容器之前强制构建镜像（即，为 [docker-compose up](https://docs.docker.com/compose/reference/up/)命令添加  `--build` 选项）。

有关可用选项的更多信息，请参阅 [Docker compose 运行配置](docker-compose-run-configuration.html)。

5. 点击   确定  保存 Docker Compose 运行配置，在主工具栏中选择它，然后点击 ![“运行”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg)或按 `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `⌘ ⌥ ⇧ R` (Xcode), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `Ctrl+F5` (ReSharper), `⌃ F5` (ReSharper (macOS)), `Ctrl+R` (QtCreator), `⌘ R` (QtCreator (macOS)), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS))启动该配置。

> **Tip:**
> 要快速创建一个  Docker Compose  运行配置并使用默认设置运行它，请在   项目   工具窗口中右键点击一个 Docker Compose 文件，然后在上下文菜单中点击   运行  。 您还可以使用边栏图标和上下文菜单在 Docker Compose 文件中运行和管理服务。

当 Docker Compose 运行多容器应用程序时，可以使用   [服务](services-tool-window.html#docker)  工具窗口（ `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-containers.html#interacting-with-containers)。 作为 Docker Compose 一部分运行的容器列在专用的   编写  节点下，而不是   容器  节点下（该节点仅用于独立容器）。

在编辑器中打开 Docker Compose 文件时，CLion 会显示带有服务状态和可用端口操作的 [嵌入提示](inlay-hints.html)。

* 服务状态 每个服务名称旁都会显示状态嵌入提示，指示服务是运行中还是失败。 点击嵌入提示会跳转到 服务 工具窗口中的容器日志。 ![在编辑器中的 Docker Compose 文件里显示服务状态](https://resources.jetbrains.com/help/img/idea/2026.3/docker-compose-state-inlay.png)

* 端口操作（打开 URL） 对于暴露端口的服务，CLion 会在编辑器中直接提供快捷操作： * 在浏览器中打开 ：在默认浏览器中打开服务 URL。 * 连接到数据库 ：打开相应的数据库连接流程，允许直接从 IDE 检查数据库并运行查询。 如需了解更多信息，请参阅 [数据源](managing-data-sources.html)。 > **Note:** > 端口操作目前仅适用于本地 Docker 环境。

Procedure: 扩展服务

1. 在   服务   工具窗口中，选择您要扩展的服务并点击 ![“缩放”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.expandAll.svg) 或从上下文菜单中选择   扩展  。

![“扩展”上下文菜单项](https://resources.jetbrains.com/help/img/idea/2026.3/96_DockerComposeScaleService.png)

2. 在   扩展  对话框中，指定您想要为此服务创建的容器数量，然后点击   确定  。

Procedure: 停止运行中的服务

* 在   服务   工具窗口中，选择服务并点击 ![停止按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.stop.svg) 或从上下文菜单中选择   停止  。

![“停止”上下文菜单项](https://resources.jetbrains.com/help/img/idea/2026.3/98_DockerComposeServiceStart.png)

Procedure: 停止所有正在运行的服务

* 在   服务  工具窗口中，选择   编写  节点，然后点击 ![停止按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.stop.svg)或从上下文菜单中选择   停止  。

Procedure: 关闭您的应用程序

* 在   服务  工具窗口中，选择   编写  节点，然后点击 ![下线按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.nodes.undeploy.svg)或从上下文菜单中选择   下  。

这将停止并删除容器以及所有相关的网络、卷和镜像。

Procedure: 打开用于运行应用程序的 Docker Compose 文件

* 在   服务  工具窗口中，右键点击   编写  节点或嵌套的服务节点，然后在上下文菜单中点击   跳转到源  或按 `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))。

## See also

### 参考

[服务工具窗口](services-tool-window.html)

