首页/云/Kubernetes 速查/挂载点会遮蔽目录原有内容
配置与存储54 条

挂载点会遮蔽目录原有内容

把卷挂到容器里已有文件的目录时,原内容被遮蔽而不是合并:nginx 的 /etc/nginx/conf.d、应用的 conf 目录都常踩这个点。

Kubernetes 速查云更新于 2026-10-12

现象

现象
volumeMounts:
  - name: config
    mountPath: /etc/nginx/conf.d   # 镜像自带的 default.conf 被遮住,不会合并

规避手段

规避手段
1) 挂到新目录,再用 include 指向它
2) subPath 只挂单个文件(注意其不更新语义)
3) initContainer 先把镜像原内容拷到 emptyDir,再整体挂回
要「保留原目录内容并补一个文件」,优先 subPath 单文件挂载或 initContainer 预拷贝。

易错点

  • 在容器里发现「配置文件丢了」,先确认是否为挂载遮蔽,而非镜像问题
  • 挂载在容器启动前完成,应用看不到被遮蔽内容,不存在自动合并

数据来源与参考

  • Kubernetes 官方文档 · Volumes(挂载遮蔽说明)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌