首页/云/Docker 容器速查/compose include 复用其他文件
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条
Compose 编排55 条
资源与安全50 条容器排障52 条

compose include 复用其他文件

较新的 Compose v2 支持顶层 include:把网络、监控等公共定义拆成独立文件后引入,多个项目可以共享同一份基础编排。

Docker 容器速查云更新于 2026-10-12
字段include: [路径…] 或带 path 的映射
路径语义相对当前 compose 文件
合并结果包含进同一项目,用 config 核对

示例

示例
include:
  - path: ./infra/compose.network.yaml
  - path: ../shared/compose.monitoring.yaml

services:
  api:
    image: app/api:1.4.2
被 include 的文件可继续有自身 include;跨目录引用注意相对路径基准是引用方文件所在目录。

易错点

  • 被 include 文件里的服务会进入同一项目命名空间,重名服务会冲突
  • 老版本 Compose 不支持 include,团队内版本基线要先统一

数据来源与参考

  • Docker 官方文档:Compose include(docs.docker.com/compose/multiple-compose-files/include)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌