如何在Docker Compose中用OverlayFS挂载hostdir1保留镜像文件

要实现「保留镜像内原有文件、补充主机目录文件，且镜像内同名文件优先级高于主机」的效果，Docker普通绑定挂载无法直接满足需求，需借助OverlayFS挂载实现目录叠加。以下是两种可行配置方案：

方案一：容器内动态挂载OverlayFS（需特权模式） #

通过容器启动时手动创建OverlayFS挂载，将主机目录设为底层（lowerdir），镜像内目标目录设为上层（upperdir），既保留镜像文件优先级，又叠加主机新增文件。

docker-compose.yml 配置示例 #

version: '3.8'
services:
  php-service:
    build: . # 指向你的Dockerfile所在目录
    volumes:
      # 主机hostdir1以只读方式挂载到容器临时目录
      - ./hostdir1:/host-source:ro
    command: >
      sh -c "
      # 创建OverlayFS所需的工作目录与临时挂载点
      mkdir -p /overlay-work /temp-mount &&
      # 挂载OverlayFS：底层为主机目录，上层为镜像内/mount
      mount -t overlay overlay -o lowerdir=/host-source,upperdir=/mount,workdir=/overlay-work /temp-mount &&
      # 替换原/mount为叠加后的目录
      rm -rf /mount &&
      mv /temp-mount /mount &&
      # 启动PHP服务（替换为实际启动命令，如php-fpm或apache2-foreground）
      exec php-fpm
      "
    # 开启特权模式以允许容器内执行挂载操作
    privileged: true

关键说明 #

• 主机目录设为只读（ro），避免容器意外修改主机文件
• 镜像内/mount作为上层目录，同名文件（如1.txt）会覆盖主机版本
• 特权模式（privileged: true）是必要条件，确保容器能执行mount系统调用

方案二：直接配置Docker Overlay类型挂载（灵活性较低） #

若不想在容器内执行挂载命令，可直接在Compose中配置type: overlay挂载，但需提前获取镜像对应的Overlay层路径，适合镜像固定的场景。

步骤1：获取镜像Overlay层路径 #

运行命令查询你的PHP镜像对应的Overlay目录：

# 替换为你的镜像名称或ID
docker inspect --format '{{.GraphDriver.Data.UpperDir}}' your-php-image

输出路径类似/var/lib/docker/overlay2/abcdef123456/diff，需取该路径下的/mount目录，即/var/lib/docker/overlay2/abcdef123456/diff/mount

步骤2：docker-compose.yml 配置示例 #

version: '3.8'
services:
  php-service:
    build: .
    volumes:
      - type: overlay
        target: /mount
        volume:
          lowerdir: ./hostdir1
          upperdir: /var/lib/docker/overlay2/abcdef123456/diff/mount
          workdir: /var/lib/docker/overlay2/abcdef123456/work

关键说明 #

• lowerdir指定主机hostdir1为底层目录
• upperdir指定镜像内/mount对应的Overlay层路径为上层目录
• workdir需与镜像Overlay层的工作目录保持一致
• 无需特权模式，但镜像更新后需重新查询Overlay路径，维护成本较高

效果验证 #

启动容器后，进入容器检查/mount目录：

docker exec -it your-container-name ls /mount
# 应显示：1.txt、2.txt、4.txt、5.txt、somedir/
cat /mount/1.txt
# 输出应为internal（镜像内的内容）
cat /mount/2.txt
# 输出应为主机hostdir1内的内容

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