基于官方Wordpress镜像构建自定义镜像挂载Volume后文件丢失问题

问题原因 #

官方Wordpress基础镜像的Dockerfile中预先声明了VOLUME /var/www/html，该声明会触发Docker的卷挂载逻辑：

• 当你显式通过-v wp-volume:/var/www/html指定卷挂载到该路径时，Docker会直接将外部卷的内容覆盖容器内/var/www/html路径的全部内容，你在镜像构建阶段复制到该路径下的文件会被完全遮挡，所以无法访问。
• 当你不指定显式卷挂载时，Docker会为镜像预先声明的VOLUME自动创建匿名卷，此时会默认将镜像内/var/www/html路径下的所有原有文件预填充到匿名卷中，因此可以正常看到你构建时复制的插件文件。

可行解决方案 #

• 方案一（推荐）：缩小挂载范围
  不直接挂载整个/var/www/html目录，仅挂载需要持久化的子目录，比如用户上传资源目录：

  docker run -d --name wp -v wp-volume:/var/www/html/wp-content/uploads newimage
  

  该方案下wp-content/plugins目录不会被卷覆盖，可正常读取镜像内预置的插件文件，同时满足核心数据持久化需求。

• 方案二：启动阶段复制文件
  若必须挂载整个/var/www/html目录，可修改Dockerfile添加自定义启动脚本，在容器每次启动时检测目标路径是否存在预置插件，不存在则从临时目录复制：

  FROM wordpress
  # 先把插件复制到临时目录
  COPY . /tmp/my-plugins
  # 编写启动脚本
  RUN echo '#!/bin/bash \n\
  cp -rn /tmp/my-plugins/* /var/www/html/wp-content/plugins/ \n\
  exec docker-entrypoint.sh apache2-foreground' > /custom-entrypoint.sh && \
  chmod +x /custom-entrypoint.sh
  ENTRYPOINT ["/custom-entrypoint.sh"]
  

• 方案三（不推荐）：移除基础镜像的VOLUME声明
  自行构建Wordpress基础镜像，删除原Dockerfile中的VOLUME /var/www/html行，再基于该自定义基础镜像构建你的镜像，该方案会破坏官方镜像默认的持久化逻辑，容易出现数据丢失风险。

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