容器与云原生 / 系统课时

Volume 挂载后文件怎么不见了

Volume 挂载后文件怎么不见了

镜像里明明有配置或静态文件,一加 volumes 挂载就“消失”,通常不是 Docker 删除了文件,而是挂载点把镜像原有目录遮住了。本节用可复现案例确认这一行为,并给出 bind mount 与 named volume 各自的定位和修复方法。

学习目标

  • 解释挂载为什么会遮盖容器镜像中的原始文件
  • 区分 bind mount 与 named volume 首次挂载时的行为
  • 按挂载类型定位数据来源,并选择不会误删数据的修复方式

先确认文件是被遮盖,不是被删除

容器启动时,镜像文件系统先提供目标路径原有内容;随后 Docker 再把宿主目录或 Volume 挂到同一路径。挂载完成后,进程看到的是挂载源中的内容,而不是下层镜像目录。删除并重建一个不带该挂载的容器,原始镜像文件仍会出现。

bind mount 最直观:例如把宿主机空目录 ./html 挂到容器的 /usr/share/nginx/html,空目录就会覆盖该路径的视图,因此镜像自带的 index.html 暂时不可见。这类现象的关键是“遮盖”而不是“删除”:挂载仍在时,容器路径展示的是上层挂载源的内容。([Docker Documentation][1])

挂载层遮盖镜像原始文件的关系

用最小案例复现遮盖行为

下面让两个服务使用同一 Nginx 镜像:image-view 不挂载目录,mounted-view 把一个空宿主目录覆盖到 Nginx 默认站点目录。第二个服务检测不到 index.html,就能证明差异来自挂载。

bash
rm -rf demo-html
mkdir demo-html

cat > compose.yaml <<'YAML'
services:
  image-view:
    image: nginx:alpine
    command:
      - sh
      - -c
      - 'test -f /usr/share/nginx/html/index.html && echo index=present || echo index=missing'

  mounted-view:
    image: nginx:alpine
    volumes:
      - ./demo-html:/usr/share/nginx/html
    command:
      - sh
      - -c
      - 'test -f /usr/share/nginx/html/index.html && echo index=present || echo index=hidden'
YAML

docker compose run --rm image-view
docker compose run --rm mounted-view

预期输出如下。首次执行可能另外出现镜像拉取和网络创建日志,这些日志随环境变化。

text
index=present
index=hidden

这里并没有删除镜像中的文件。mounted-view 结束后,直接检查宿主机的 demo-html 仍是空目录;只要换成不带该挂载的新容器,镜像原始页面仍然存在。

Named Volume 还有一次初始化复制

named volume 也会遮盖挂载目标,但有一个关键差异:当 Volume 是新建且为空时,Docker 默认会把容器目标目录中已有文件复制进该 Volume,再完成挂载。因此第一次把空 Volume 挂到带默认文件的目录时,看起来文件没有消失。若 Volume 已经有内容,则它自己的内容会遮盖镜像目录。也可以通过 Compose 的 volume.nocopy 关闭首次复制。([Docker Documentation][2])

这会带来另一类常见误判:镜像重新构建后已经包含新版文件,但旧 named volume 仍保存着此前复制进去的旧文件,于是容器继续看到旧版本。此时问题不是镜像构建失败,而是持久化 Volume 的内容优先出现在挂载点。

按挂载来源决定修复方式

先看最终生效的 Compose 配置,确认目标路径到底是 bind mount 还是 named volume,再沿着 source → target 查数据。对于 bind mount,真正要检查的是宿主 source 是否为空、路径是否写错,以及相对路径是否基于预期的 Compose 项目目录。对于 named volume,则要确认是否复用了旧 Volume,以及其中是否已有历史文件。

如果目标是使用镜像自带文件,最稳妥的修复是移除覆盖该目录的挂载并重建容器。如果目标是开发态同步文件,就应先把宿主目录准备完整,或者把挂载范围缩小到真正需要覆盖的子目录。对于需要持久化的数据目录,应把“程序随镜像发布的文件”和“运行期数据”拆到不同路径,避免一个 Volume 同时承担发布和持久化两种职责。

排查这类问题时,先问“这个路径现在由谁提供内容”,比反复重建镜像更有效:挂载存在时,容器在挂载点看到的始终是挂载源的视图;镜像原始文件是否存在,要在不带该挂载的容器中判断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Volume 挂载后文件怎么不见了

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通