# Docker compose 运行配置

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

> **TL;DR**
> 创建：  `运行 | 编辑配置 |`  ![添加新配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  `| Docker compose`

使用此类配置来运行多容器 Docker 应用程序。

Docker 使用 [docker compose](https://docs.docker.com/compose/reference/) 命令来定义、配置和运行多容器应用程序。 构建、创建、启动并附加到容器的主要命令是 [docker compose up](https://docs.docker.com/compose/reference/up/)。

> **Note:**
> 默认情况下，CLion 假设您正在运行 Compose V2。 但是，如果您运行的是停用的 Compose V1，那么  `docker compose` 命令将不起作用。 在这种情况下，您需要手动指定  `docker compose`  可执行文件的位置 [Docker 连接设置](settings-docker.html)。
>
>
>
> 如需了解更多信息，请参阅 [迁移到 Compose V2](https://docs.docker.com/compose/migrate/)。

默认情况下，   Docker Compose   配置具有以下选项：

|  项  |  描述  |
| --- | --- |
|    名称    |  为运行配置指定一个名称，以便在编辑或运行时能快速识别。  |
|    允许多个实例    |     允许并行运行多个此运行配置实例。       默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，CLion建议停止正在运行的实例并启动另一个实例。 这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。     |
|    存储为项目文件    |     将运行配置设置保存到文件中，以便与其他团队成员共享。 默认位置是  `.idea/runConfigurations` 。 但是，如果您不想共享  `.idea` 目录，您可以将配置保存到项目中的任何其他目录。       默认情况下，它是禁用的，并且 CLion 将运行配置设置存储在  `.idea/workspace.xml` 。     |
|    服务器    |  请选择要用于运行配置的 [Docker daemon connection](docker.html#connect_to_docker)。  |
|    Compose 文件    |     指定定义必要服务的 compose 文件。 Docker Compose 按指定顺序构建配置，因此任何后续文件都会覆盖并添加到前一个文件中相同服务的字段。       这与使用  `-f`  选项和  `docker compose`  命令相似。     |
|    服务    |     指定要构建、创建和启动的服务。       点击 ![“Browse 图标”](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 以选择 YML 文件中列出的服务。      ![docker-compose 浏览 图标](https://resources.jetbrains.com/help/img/idea/2026.3/db_docker_compose_browse_icon.png)  |
|    启动前    |     指定在开始运行配置之前执行的任务列表。 例如，运行其他配置，构建必要的工件，运行一些外部工具或网络浏览器，等等。       点击 ![添加按钮](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)), `⌘ 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)) 以添加一个可用的任务。       在列表中使用 ![上移按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveUp.svg) 和 ![下移按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg) 移动任务，以更改执行任务的顺序。 选择任务并点击 ![“编辑”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg)以编辑任务。 点击 !["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg) 以从列表中删除所选任务。     |
|    显示此页面    |  在实际启动前显示运行配置设置。  |
|    激活工具窗口    |     根据配置类型，启动此运行配置时会打开 [运行](run-tool-window.html)、 [调试](debug-tool-window.html)或 [服务](services-tool-window.html)工具窗口。 如果此选项被禁用，您可以手动打开工具窗口：        * `视图 \| 工具窗口 \| 运行` 或 `Alt+4` (Windows), `⌘ 4` (macOS), `⌘ 4` (IntelliJ IDEA Classic (macOS)), `⌘ 4` (macOS System Shortcuts), `Alt+4` (XWin), `Alt+4` (GNOME), `Alt+4` (KDE), `Alt+4` (Emacs), `Alt+4` (Sublime Text), `⌘ 4` (Sublime Text (macOS)), `⌘ 6` (Xcode), `Alt+4` (Visual Studio), `⌘ 4` (Visual Studio (macOS)), `Alt+4` (ReSharper), `⌘ 4` (ReSharper (macOS)), `Alt+3` (QtCreator), `⌘ 3` (QtCreator (macOS)), `Alt+4` (NetBeans), `Alt+4` (Eclipse), `⌘ 4` (Eclipse (macOS))    * `查看 \| 工具窗口 \| 调试` 或 `Alt+5` (Windows), `⌘ 5` (macOS), `⌘ 5` (IntelliJ IDEA Classic (macOS)), `⌘ 5` (macOS System Shortcuts), `Alt+5` (XWin), `Alt+5` (GNOME), `Alt+5` (KDE), `Alt+5` (Emacs), `Alt+5` (Sublime Text), `⌘ 5` (Sublime Text (macOS)), `⌘ 7` (Xcode), `Alt+5` (Visual Studio), `⌘ 5` (Visual Studio (macOS)), `Alt+5` (ReSharper), `⌘ 5` (ReSharper (macOS)), `Alt+5` (QtCreator), `⌘ 5` (QtCreator (macOS)), `Alt+5` (NetBeans), `Alt+5` (Eclipse), `⌘ 5` (Eclipse (macOS))    * `查看 \| 工具窗口 \| 服务` 或 `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 Compose 指定一个备用的项目名称。默认情况下，它是当前目录的名称。 默认情况下，它是当前目录的名称。       这与使用  `-p`  选项和  `docker compose`  命令相似。     |
|    配置文件    |     为您的应用程序指定 [配置文件](https://docs.docker.com/compose/how-tos/profiles/) 以适应不同的环境或用例。       配置文件让您能够将服务分组，并在需要时才激活它们，从而使单个  `compose.yml`  文件能够支持多种场景（例如，开发、调试或生产环境）。       您可以指定多个配置文件；使用逗号分隔它们。     |
|    环境变量    |  指定 [Docker Compose 环境变量](https://docs.docker.com/compose/reference/envvars/)。 这些仅由 Docker Compose 进程使用。 它们不会传递给任何容器。  |
|    环境变量文件    |     指定路径到自定义 [环境文件](https://docs.docker.com/compose/env-file/)，以定义 [Docker Compose 环境变量](https://docs.docker.com/compose/reference/envvars/)。       这与使用  `--env-file`  选项和  `docker compose`  命令相似。       默认情况下，   Docker Compose   运行配置会在包含 Docker Compose 文件的目录中查找名为  `.env`  的文件。     |
|    启用兼容模式    |     将 v3 服务定义转换为兼容 v2 的参数。       这与使用  `--compatibility`  选项和  `docker compose`  命令相似。     |
|    在 `down` 时移除孤立项。    |  在带下应用程序时移除当前 Compose 文件中未定义的服务的容器。  |
|    在 `down` 时移除卷。    |     停止和移除容器时，还会删除在 Docker Compose 文件中声明的命名卷以及附加到容器的匿名卷。       这类似于使用  `-v` 或  `--volumes` 选项与  `docker compose down` 命令。     |
|    在 `down` 时移除镜像。    |     配置停止和移除容器时应删除的镜像。 您可以选择删除任何服务使用的所有图像，或仅删除在  `image`  字段中未设置自定义标签的图像。       这与使用  `--rmi`  选项和  `docker compose down`  命令相似。     |
|    SIGKILL 超时时间    |     设置超时时间（以秒为单位），以强制终止未正常关闭的容器。       Docker 首先尝试使用  `SIGTERM`  进行正常关闭，但容器可能会无限期地继续运行。 设置超时时间，之后 Docker 应发送  `SIGKILL`  来强制关闭。       这类似于使用  `-t` 或  `--timeout` 选项与  `docker compose up` 命令。     |
|    返回退出码    |     返回已选择服务容器的退出代码。       每当所选服务中的容器停止时，返回其退出代码并停止服务中的所有其他容器。       这类似于在  `docker compose up`  命令中使用  `--exit-code-from`  和  `--abort-on-container -exit`  选项。     |
|    重写缩放。    |     为每个服务设置要启动的容器数量。       此选项将覆盖 Docker Compose 文件中的  `scale`  参数（如果存在）。       这与使用  `--scale`  选项和  `docker compose up`  命令相似。     |
|    重新创建依赖项    |     启动服务时重新创建依赖容器。       这与使用  `--always-recreate-deps`  选项和  `docker compose up`  命令相似。     |
|    重新创建匿名卷    |     重新创建匿名卷，而不是从以前的容器中检索数据。       这类似于使用  `-V` 或  `--renew-anon-volumes` 选项与  `docker compose up` 命令。     |
|    移除孤立项    |     删除 Docker Compose 文件中未定义的服务的容器。       这与使用  `--remove-orphans`  选项和  `docker compose up`  命令相似。     |
|    日志中不打印前缀    |  禁用日志输出中的服务名称前缀，以生成更简洁、简单的日志。  |
|    启动    |     配置要启动的服务：        * 已选择和依赖项 ：默认情况下，Docker Compose 会启动所有指定的服务及其关联服务。    * 无 ：创建服务后不要启动它们。 这类似于使用 `--no-start` 选项与 `docker compose up` 命令。    * 已选择的服务 ：不要启动任何已链接的服务。 这类似于使用 `--no-deps` 选项与 `docker compose up` 命令。    |
|    附加到    |     配置要显示输出流的容器：        * 已选择的服务 ：默认情况下，Docker Compose 会附加到指定服务的所有已启动容器。    * 无 ：不要附加到任何容器。 这类似于使用 `-d` 或 `--detach` 选项与 `docker compose up` 命令。    * 已选择和依赖项 ：连接到指定服务和关联服务的容器。 这类似于使用 `--attach-dependencies` 选项与 `docker compose up` 命令。    |
|    重新创建容器    |     配置要停止并替换为新容器的容器：        * 配置已更改 ：默认情况下，Docker Compose 仅在相应的配置或镜像发生更改时才会重新创建容器。    * 全部 ：重新创建服务中的所有容器，即使相应的配置或镜像没有更改。 这类似于使用 `--force-recreate` 选项与 `docker compose up` 命令。    * 无 ：即使相应的配置已更改，也不要在服务中重新创建任何容器。 这类似于使用 `--no-recreate` 选项与 `docker compose up` 命令。    |
|    构建    |     配置在启动容器之前要构建的镜像：        * 仅缺失的镜像 ：默认情况下，Docker Compose 只构建不可用的镜像，并在可能的情况下使用先前构建的镜像。    * 从不 ：不要构建任何图像。 始终使用以前构建的镜像，如果某些镜像不可用则抛出错误。 这类似于使用 `--no-build` 选项与 `docker compose up` 命令。    * 始终 ：在启动容器之前始终构建镜像。 这类似于使用 `--build` 选项与 `docker compose up` 命令。    |
|    停止容器    |     配置如何停止服务中的容器。 默认情况下，Docker Compose 不会停止服务中的其他容器。 您需要手动停止他们。       但是，您可以选择在服务中的任何容器停止时停止所有容器。 这与使用  `--abort-on-container-exit`  选项和  `docker compose up`  命令相似。     |

