首页/云/Docker 容器速查/单文件绑定挂载的注意事项
网络与存储52 条

单文件绑定挂载的注意事项

把宿主上的单个文件挂进容器(如配置文件):文件必须已存在,且宿主侧编辑方式会影响到容器能否看到更新。

Docker 容器速查云更新于 2026-10-12
用途挂载单个文件
写法-v /host/config.yml:/app/config.yml:ro
本质按 inode 绑定,文件需预先存在

示例

示例
touch $PWD/config.yml
docker run --rm -v $PWD/config.yml:/app/config.yml:ro alpine cat /app/config.yml
# 用重写型编辑器改完后验证容器内是否可见
docker exec <容器> cat /app/config.yml
vim 等编辑器保存时可能替换 inode(写新文件再改名),容器绑定的是旧 inode,表现为配置改了但不生效。

易错点

  • 容器读到的仍是旧文件时需要重启容器重建挂载,或改用目录挂载规避 inode 问题
  • 源文件不存在时 -v 会创建同名目录,容器里把目录当配置文件读会直接报错

数据来源与参考

  • Docker 官方文档:bind mounts 单文件挂载行为(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌