docker-compose.yaml中volumes配置定义及主机目录挂载问题咨询

核心问题原因说明 #

你遇到的报错是因为混淆了Docker Compose中两种挂载方式的配置规则：顶级volumes段仅用于声明Docker管理的命名卷，命名卷名称仅支持字母、数字、.、_、-字符，不能包含路径分隔符/，所以填写temp/my-data/不符合规则才会触发正则校验报错。

两种挂载方式的配置规则 #

1. 绑定挂载（你的需求场景适用） #

这就是你熟悉的「主机指定目录映射到容器路径」的模式，不需要在顶级volumes段做任何声明，直接在服务的volumes配置项里写路径映射即可：

• 相对路径默认相对于docker-compose.yaml文件所在的目录，也可以写主机绝对路径避免歧义
• 不需要提前在顶级volumes段声明路径，也不需要提前手动创建主机目录（Docker会自动创建缺失的目录）

对应你的需求，正确配置如下：

version: "3.9"

services:
  db:
    image: db
    volumes:
      # 相对路径写法，temp目录和docker-compose.yaml在同级目录
      - ./temp/my-data/:/var/lib/db

2. 命名卷（官方示例使用的模式） #

这是Docker统一管理的存储卷，默认存放在Docker系统目录/var/lib/docker/volumes/下，不由用户手动指定主机存储路径，适合多服务共享数据、不需要直接操作主机文件的场景：

• 需要在顶级volumes段声明用到的卷名，Docker会自动创建管理卷，不需要你提前在主机创建同名目录
• 仅在需要多个服务共享同一份数据时推荐使用

如果需要将命名卷绑定到你指定的主机temp/my-data/路径，可以通过driver_opts参数自定义存储位置，配置如下：

version: "3.9"

services:
  db:
    image: db
    volumes:
      - data-volume:/var/lib/db
  backup:
    image: backup-service
    volumes:
      - data-volume:/var/lib/backup/data

volumes:
  # 自定义命名卷名，符合命名规则
  data-volume:
    driver: local
    driver_opts:
      type: none
      o: bind
      # 填写主机目录的绝对路径，需要提前创建好该目录
      device: /你的主机绝对路径/temp/my-data

常见疑问澄清 #

• 官方示例中的data-volume不需要提前在主机创建同名目录：它是Docker维护的命名卷，存储位置由Docker统一管理
• 顶级volumes段只能填写符合命名规则的自定义卷名，不能直接填写主机路径

内容的提问来源于stack exchange，提问作者user842225