Docker挂载配置文件却变成目录:检查宿主路径

适用范围:Docker Engine和Compose绑定挂载;不要直接删除未知目录或数据库挂载。

本来想把一个配置文件挂进容器,结果容器看到的却是目录,通常先检查宿主源路径。使用某些简写挂载形式时,不存在的源路径可能被自动创建成目录;这不是配置文件成功生成了。

先看源路径和目标类型

在Docker守护进程所在机器执行,不是在随便一台运行客户端的电脑上检查:

ls -ld -- /srv/app/config.yml
file -- /srv/app/config.yml
docker inspect --format '{{json .Mounts}}' app

把容器名和路径换成实际值。检查Type、Source、Destination,以及目标是文件还是目录。不要为看挂载而把完整inspect输出公开,其中可能含环境变量凭据。[1]

分清-v与--mount的缺失路径行为

Docker Engine的 -v 宿主路径:容器路径 在缺失源路径时可能创建目录。--mount type=bind 默认会对不存在的源路径报错,能更早暴露拼写问题。[1]

需要挂载单个文件时,先明确创建和检查该文件,再配置只读挂载。配置文件丢失不能用空文件占位掩盖,否则程序可能按不安全的默认值启动。

在Compose中避免无意创建目录

可在现有文件的volumes片段采用长语法:

volumes:
  - type: bind
    source: /srv/app/config.yml
    target: /app/config.yml
    read_only: true
    bind:
      create_host_path: false

该片段需放到具体服务下。用当前Compose版本验证是否支持,并先确认源文件存在;相对路径还要核对配置文件基准目录。[2]

已经生成的错误目录怎样处理

先停止或迁移受影响的测试服务,查看目录是否被其他容器使用、里面是否有数据,再备份。只有确认是本次错误生成且无业务内容,才按变更流程移走或清理,并恢复正确文件。不要直接执行递归删除。

绑定挂载还会遮住镜像目标位置原有的内容;看到空目录,不代表镜像内的配置已经消失。修正源后重新创建对应容器,不能只在旧容器里临时补文件当成永久修复。

验收

检查挂载类型和路径,验证运行用户能读取、程序加载了正确配置。只读文件应不能被容器内进程改写。再重建一次测试容器确认修复可重复,才把同样的变更应用到生产。

继续排查

容器重建后数据还在吗?数据卷与目录挂载的使用方法;Docker挂载目录无权访问,先核对运行身份。

技术依据:[1] Docker bind mounts语法与路径行为;[2] Compose volumes长语法与create_host_path。适用版本见本文说明。