为何Docker卷内文件未被覆盖？卷与镜像构建机制咨询

问题背景 #

我正在学习Docker卷的相关知识：

• 直接使用docker build -t myserver .和docker run -dp 8080:80 myserver构建运行镜像时，Web服务器显示“Hallo”；修改Dockerfile内容为“Huhu”后重新构建运行，服务器正常显示“Huhu”，符合预期。
• 之后添加了包含两个卷的docker-compose.yaml，一个挂载到Dockerfile生成index.html的路径/usr/share/nginx/html，另一个挂载到新路径/persistent。第一次执行docker compose up --build后，服务器显示“Hallo”，Docker GUI中能看到两个卷及内容，镜像里的index.html已同步到卷中。
• 但将Dockerfile里的内容改为“Huhu”并再次执行docker compose up --build后，服务器仍显示“Hallo”，Dockerfile的修改没有覆盖卷中的数据，想知道原因。

相关文件 #

Dockerfile

FROM nginx

# First build
RUN echo "Hallo" > /usr/share/nginx/html/index.html

# Second build
# RUN echo "Huhu" > /usr/share/nginx/html/index.html

docker-compose.yaml

services:
  web:
    build: .
    ports:
      - "8080:80"
    volumes:
      - html:/usr/share/nginx/html
      - persistent:/persistent
volumes:
  html:
  persistent:

原因解析 #

这是Docker卷的初始化规则导致的：

1. 首次启动服务时，Docker会检查挂载的命名卷（这里的html卷）是否为空。如果是空卷，Docker会自动把容器对应目录（/usr/share/nginx/html）中的内容——也就是Dockerfile构建时生成的“Hallo”版本index.html——复制到卷中，完成卷的初始化。
2. 后续重新构建镜像并启动服务时，虽然镜像里已经生成了“Huhu”版本的index.html，但html卷已经存在且不为空。Docker的设计逻辑是保护卷内的数据不被镜像内容覆盖，因此会直接使用卷中已有的旧文件，导致服务器显示的还是“Hallo”。
3. 卷的核心定位是持久化动态数据（比如用户上传文件、数据库数据）或实现容器间数据共享，这种“不覆盖已有卷”的规则是为了避免用户的数据意外丢失。

解决方法 #

如果需要让新镜像的内容覆盖卷，可采用以下两种方式：

• 删除现有卷后重建：执行docker compose down -v彻底删除服务及关联的卷，再运行docker compose up --build，此时卷会重新初始化，加载新镜像里的内容。
• 调整卷的使用方式：如果index.html属于应用代码的一部分，不应该用卷挂载这个目录，而是直接将代码打包进镜像。卷只用来挂载需要持久化的动态数据目录。

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