Mounts 是 docker inspect 查看容器挂载路径的核心字段,其数组每项包含源路径、目标路径、类型和读写权限等真实运行时信息,HostConfig.Binds 已过时且不完整。

docker inspect 查看容器挂载路径的核心字段是 Mounts
直接执行 docker inspect ,返回的 JSON 中真正描述挂载关系的是 Mounts 数组,不是 Volumes 或 HostConfig.Binds(后者已过时且不完整)。这个数组每项对应一个挂载点,包含源路径、目标路径、挂载类型、读写权限等关键信息。
常见错误是只扫一眼就去找 HostConfig.Binds,但 Docker 20.10+ 版本中它可能为空或缺失 bind 挂载细节;而 Mounts 始终准确反映运行时实际挂载状态。
- 用
docker inspect -f '{{json .Mounts}}'可只提取挂载部分,避免翻长 JSON - 如果容器用了 named volume,
Source字段显示的是宿主机上的真实路径(如/var/lib/docker/volumes/myapp_data/_data),不是 volume 名 - 对于 bind mount,
Source就是用户指定的绝对路径(如/home/user/app/logs),注意检查是否带尾部斜杠——Docker 不自动补,路径错会导致挂载失败但容器仍可能启动
区分 bind mount 和 volume mount 的 Source 表现形式
同一个 Mounts 条目里,Type 字段决定 Source 含义:
-
Type: "bind"→Source是你-v /host/path:/container/path里写的宿主机路径,必须存在且有权限 -
Type: "volume"→Source是 Docker 管理的内部路径,通常形如/var/lib/docker/volumes/;此时不能直接依赖 volume 名去猜路径,得靠/_data inspect实际查 -
Type: "tmpfs"→Source为空,挂载点纯内存,无宿主机路径
误把 volume 名当宿主机路径去操作(比如 ls /var/lib/docker/volumes/myvol 而不是 /var/lib/docker/volumes/myvol/_data)是高频问题,_data 子目录才是真实数据落盘位置。
快速定位某个容器内路径对应的宿主机路径
假设你想知道容器里 /app/config 这个目录实际映射到宿主机哪——别手动翻 Mounts 数组,用 Go template 精准过滤:
docker inspect -f '{{$m := .Mounts}}{{range $m}}{{if eq .Destination "/app/config"}}{{.Source}}{{end}}{{end}}' mycontainer
这条命令会遍历所有挂载项,只输出 Destination 等于 /app/config 的那个 Source。注意 .Destination 是容器内路径,必须完全匹配(包括开头的 /)。
- 如果没输出,说明该路径未被挂载,只是容器镜像自带的文件系统层
- 如果输出多个结果,说明有多个挂载点目标重叠(极少见,但 Docker 允许,后挂载的会覆盖前一个)
- 模板里不能用双引号嵌套双引号,所以用单引号包裹整个
-f参数,内部字符串用双引号
挂载路径权限和一致性容易被忽略的点
Mounts 输出里 Mode 字段只显示 z 或 Z(SELinux)或空,不体现 ro/rw——读写权限得看 RW 字段(布尔值)。但更隐蔽的问题是:即使 RW:true,宿主机路径的 umask、父目录权限、user namespace 映射都可能导致容器内进程无法写入。
- bind mount 下,宿主机路径的属主/属组不会自动适配容器内 UID/GID;若容器以非 root 用户运行,而宿主机目录属 root,就会写入失败
- named volume 默认以 root 创建,同样可能引发权限问题,建议初始化时用
docker run --rm -v myvol:/target alpine chown 1001:1001 /target预置权限 -
Mounts不反映挂载时加的:delegated或:cached(仅 macOS/Windows),这些选项只出现在HostConfig.Binds或 CLI 命令里,运行时不可见
Inspect 能告诉你“挂在哪”,但不能代替对权限模型和存储驱动行为的理解。尤其在生产环境排查文件写入失败时,先确认 Mounts 正确,再逐层检查宿主机路径权限、SELinux/AppArmor 策略、以及容器用户与宿主机用户的 UID 对齐情况。











