Docker Compose挂载多文件/目录失效，如何实现主机容器文件同步？

你的核心问题是错误使用了volume类型来挂载本地文件——Docker的volume类型对应Docker管理的存储卷（命名卷/匿名卷），而非主机文件与容器的绑定挂载。这也是docker inspect显示Mounts为空的根本原因，配置语法不符合绑定挂载的要求。

正确的docker-compose.yml配置示例 #

services:
  portal:
    container_name: portal
    image: portal
    build:
      context: .
    extra_hosts:
      - "host.docker.internal:host-gateway"
    volumes:
      # 挂载主机当前目录到容器内目录（目录绑定）
      - ./:/var/www/portal
      # 绑定挂载本地参数文件到容器指定路径（长格式写法）
      - type: bind
        source: ./local/parameters.local.yml
        target: /var/www/portal/s/config/parameters.yml
        read_only: false # 可选，需只读权限可设为true
      # 绑定挂载Apache配置文件（短格式写法，更简洁）
      - ./portal.conf:/etc/apache2/sites-available/portal.conf
      # 挂载Docker命名卷（原有配置保留）
      - awscreds:/root/.aws:ro

# 声明命名卷（原有配置保留）
volumes:
  awscreds:

关键配置要点 #

• 绑定挂载的两种写法：
  • 短格式：主机路径:容器路径[:权限]，适合简单场景，比如./portal.conf:/etc/apache2/sites-available/portal.conf:ro（ro表示只读）
  • 长格式：明确指定type: bind，可添加read_only等参数，可读性更强
• 文件挂载前置条件：主机端的目标文件必须预先存在，否则Docker会自动创建同名目录，导致挂载失效
• 路径准确性：主机路径需是相对当前docker-compose.yml的路径（或绝对路径），容器内路径要精准对应目标位置
• 权限兼容：若容器内进程需修改挂载文件，需确保主机文件权限允许容器用户访问（可通过chmod调整主机文件权限，或在容器配置中指定运行用户）

挂载生效验证 #

1. 启动服务后执行docker inspect portal，查看Mounts字段，应能看到所有绑定挂载和卷的配置信息
2. 进入容器验证文件内容：docker exec -it portal cat /var/www/portal/s/config/parameters.yml，确认与主机文件一致
3. 修改主机上的parameters.local.yml或portal.conf，再次进入容器查看，确认内容已实时同步

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