首页/云/Docker 容器速查/docker volume inspect 查看卷详情
网络与存储52 条

docker volume inspect 查看卷详情

查看卷的挂载点、驱动、选项与标签:卷在宿主机的实际位置(Mountpoint)在这里,备份与容量核查都从这里开始。

Docker 容器速查云更新于 2026-10-13

命令是干什么的

docker volume inspect 查看卷的元数据:驱动、创建选项、标签以及最常用的挂载点 Mountpoint。卷在宿主机上的实际目录位置就在这里,备份、容量核查与手工排查都从这一步开始。local 驱动的卷数据目录形如 /var/lib/docker/volumes/<名称>/_data,查看它通常需要 root 权限。

基本信息

用途查看卷的元数据与实际路径
语法docker volume inspect 卷名
关键字段Mountpoint、Driver、Options、Labels、Scope
权限要求查看宿主上的 _data 目录通常需要 root
适用平台Docker Engine(Linux 宿主)

典型使用场景

  • 备份前确认卷在宿主上的实际路径
  • 统计某个卷占用的磁盘空间
  • 排查应用写入落在卷还是容器可写层
  • 核对卷使用的驱动与创建选项
  • 清理前确认卷的标签与用途

查看与核查

查看与核查
docker volume inspect pgdata                                  # 查看完整元数据
docker volume inspect pgdata --format '{{.Mountpoint}}'        # 只取挂载点
sudo du -sh "$(docker volume inspect pgdata --format '{{.Mountpoint}}')"   # 统计占用
docker volume ls --format '{{.Name}} {{.Driver}}'              # 卷与驱动一览
sudo ls -la /var/lib/docker/volumes/pgdata/_data | head        # 查看实际内容

字段逐项读法

字段含义读取要点
Name卷名称挂载与删除时都用它
Driver卷驱动local 表示数据落在本机文件系统
Mountpoint宿主上的数据目录备份与容量核查的入口
Labels卷标签可用于 prune 过滤与用途标注
Scope作用范围local 卷仅本机可用
直接在宿主目录里增删文件不会更新 Docker 侧的元数据痕迹,判断卷内实际内容以 Mountpoint 指向的目录为准。
普通用户对 /var/lib/docker 没有读取权限,统计目录大小前需要加 sudo 或换到有权限的账号执行。

核查清单

  • 确认卷名与实际路径的对应关系,避免对名称相近的卷做误操作
  • 确认驱动类型:非 local 驱动时数据并不落在本机文件系统上
  • 确认卷被哪些容器引用,可用按卷过滤的容器列表命令查看
  • 备份与清理前记录一次容量与文件数量,作为操作前后的对照基线
卷的元数据里没有内容清单,判断卷是空的还是仍有数据,需要进入目录查看,或统计文件数量与占用做对照。

易错点

  • 忘记提权:统计命令返回空或权限拒绝,容易误判为卷内没有数据
  • 把卷名与容器内挂载路径混用:宿主上看到的是 _data 目录,容器里看到的是挂载目标路径
  • 直接对宿主目录做删除或改属主:可能破坏卷内容与所有权,应通过容器或备份恢复流程处理
  • 以为 volume ls 能显示用途:匿名卷名是随机串,用途只能靠挂载关系或标签判断

数据来源与参考

  • Docker 官方 CLI 参考:docker volume inspect(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌