首页/云/Docker 容器速查/compose 顶层 volumes 与驱动配置
Compose 编排55 条

compose 顶层 volumes 与驱动配置

在顶层声明具名卷并配置驱动与标签:数据库等状态数据用它统一管理,external: true 引用项目外已存在的卷。

Docker 容器速查云更新于 2026-10-12
字段driver / driver_opts / labels / name / external
引用服务里 volumes: dbdata:/var/lib/…
外部卷external: true(不随 down -v 删除)

示例

示例
services:
  db:
    image: postgres:16-alpine
    volumes:
      - dbdata:/var/lib/postgresql/data

volumes:
  dbdata:
    driver: local
    labels:
      env: prod
  shared:
    external: true
    name: team-shared-data
卷的实际名称会带项目名前缀;跨项目共享时用 external + name 明确指向已有卷。

易错点

  • 切换项目名后卷名前缀变化,旧数据看起来消失,先 volume ls 确认是否只是换了名字
  • down -v 会删除项目声明的卷(external 卷除外),生产清理先确认声明方式

数据来源与参考

  • Docker 官方文档:Compose volumes 顶层元素(docs.docker.com/reference/compose-file/volumes)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌