如何让Docker Compose YAML片段的公共Volumes不被服务配置覆盖？

问题原因 #

Docker Compose合并服务配置时，restart、security_opt这类字段的合并策略为追加/保留，但volumes属于列表型字段，默认策略是替换——当服务自身定义volumes时，会完全覆盖公共片段里的对应配置。

解决方案 #

方法1：拆分公共Volumes为独立锚点（兼容性强）

将公共Volumes单独定义为YAML列表锚点，在服务中同时引用基础公共配置和追加自定义Volumes：

# 基础公共配置（不含Volumes）
x-common-base: &common-base
  restart: always
  security_opt:
    - no-new-privileges:true

# 公共Volumes列表
x-common-volumes: &common-volumes
  - /etc/localtime:/etc/localtime:ro
  - /var/run/docker.sock:/var/run/docker.sock:ro

services:
  myapp1:
    <<: *common-base
    volumes:
      # 先展开公共Volumes，再追加自定义项
      *common-volumes
      - ./myapp1-data:/app/data

  myapp2:
    <<: *common-base
    volumes:
      *common-volumes
      - ./myapp2-logs:/app/logs

方法2：使用Compose的!merge标签（简洁高效，需版本≥2.20.0）

Docker Compose 2.20.0及以上支持!merge标签，可直接合并列表型字段，无需拆分片段：

x-common: &common
  restart: always
  security_opt:
    - no-new-privileges:true
  volumes:
    - /etc/localtime:/etc/localtime:ro
    - /var/run/docker.sock:/var/run/docker.sock:ro

services:
  myapp1:
    <<: *common
    # 用!merge标记，让Compose合并公共与自定义Volumes
    volumes: !merge
      - ./myapp1-data:/app/data

  myapp2:
    <<: *common
    volumes: !merge
      - ./myapp2-logs:/app/logs

验证 #

执行docker compose config命令，即可看到服务的volumes字段同时包含公共配置和自定义配置，restart、security_opt也会正常保留。

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