首页/云/Docker 容器速查/compose volumes 字段写法
Compose 编排55 条

compose volumes 字段写法

服务级卷挂载:短语法写 源:目标[:ro],长语法用 type/source/target 显式声明;相对路径按项目目录解析。

Docker 容器速查云更新于 2026-10-12
短语法./data:/app/data / named:/var/lib/app / file:/etc/x:ro
长语法type / source / target / read_only
相对路径相对项目目录(默认是 compose 文件所在目录)

示例

示例
services:
  api:
    volumes:
      - ./config:/app/config:ro
      - appdata:/var/lib/app
      - type: bind
        source: ./certs
        target: /etc/ssl/private
        read_only: true

volumes:
  appdata:
长语法在迁移与排障时更清晰;相对路径随 compose 文件目录走,换目录执行要先确认项目目录。

易错点

  • 短语法里裸名称是卷名而不是目录名,误写会悄悄创建新卷
  • 宿主目录不存在时 bind 挂载在部分平台会直接失败,路径先落盘再 up

数据来源与参考

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