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

compose 文件顶层结构

一份 compose.yaml 通常包含 services、networks、volumes 三个顶层节:定义服务、声明网络与具名卷,再按需加 secrets、configs、include。

Docker 容器速查云更新于 2026-10-12
顶层节services / networks / volumes / secrets / configs
文件位置项目根目录的 compose.yaml 或 docker-compose.yml
校验docker compose config

示例

示例
services:
  web:
    image: nginx:1.27-alpine
    ports:
      - "8080:80"
  db:
    image: postgres:16-alpine
    volumes:
      - dbdata:/var/lib/postgresql/data

volumes:
  dbdata:

networks:
  default:
    driver: bridge
正式文件从 services: 开始写即可,无需写版本声明;示例缩进统一为两个空格。

易错点

  • 缩进(空格数)错误是 compose 文件最常见的失败原因,写完先跑 docker compose config
  • 顶层写着两个同名键后一个会覆盖前一个,YAML 不会报错,靠校验命令兜底

数据来源与参考

  • Docker 官方文档:Compose 文件参考(docs.docker.com/compose/compose-file)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌