在 Podman 中,如果要查看某个数据卷的详细信息,可以使用 podman volume inspect 命令。该命令用于获取数据卷的完整元数据信息(如存储路径、驱动类型、权限配置、关联容器等),是排查数据卷问题、验证配置正确性的关键手段。
运行 podman volume inspect --help 查看命令手册:
C:\Users\Administrator> podman volume inspect --help
显示一个或多个数据卷的详细信息
说明:
显示一个或多个数据卷的详细信息。
可使用 Go 模板修改默认的 JSON 输出格式。
用法:
podman volume inspect [选项] 数据卷名称 [数据卷名称...]
示例:
podman volume inspect myvol # 查看名为 myvol 的数据卷详情
podman volume inspect --all # 查看所有数据卷的详情
# 按指定 Go 模板格式查看 myvol 详情
podman volume inspect --format "{{.Driver}} {{.Scope}}" myvol
选项:
-a, --all 查看所有数据卷的详情
-f, --format string 使用 Go 模板格式化数据卷输出结果(默认值为 "json")后续将详细介绍命令用法。
(1) 查看单个数据卷详情
C:\Users\Administrator> podman volume inspect mydata
[
{
"Name": "mydata",
"Driver": "local",
"Mountpoint": "/home/user/.local/share/containers/storage/volumes/mydata/_data",
"CreatedAt": "2025-12-12T17:15:43.092832204+08:00",
"Labels": {},
"Scope": "local",
"Options": {},
"MountCount": 0,
"NeedsCopyUp": true,
"NeedsChown": true,
"LockNumber": 14
}
]上面命令用于查询 mydata 命名卷(Volume)的详细元数据和配置信息。
(2)查看多个数据卷详情(空格分隔)
C:\Users\Administrator> podman volume inspect mydata db_volume
[
{
"Name": "mydata",
"Driver": "local",
"Mountpoint": "/home/user/.local/share/containers/storage/volumes/mydata/_data",
"CreatedAt": "2025-12-12T17:15:43.092832204+08:00",
"Labels": {},
"Scope": "local",
"Options": {},
"MountCount": 0,
"NeedsCopyUp": true,
"NeedsChown": true,
"LockNumber": 14
},
{
"Name": "db_volume",
"Driver": "local",
"Mountpoint": "/home/user/.local/share/containers/storage/volumes/db_volume/_data",
"CreatedAt": "2025-12-15T09:44:19.909130724+08:00",
"Labels": {
"app": "database",
"environment": "production",
"version": "1.0"
},
"Scope": "local",
"Options": {},
"MountCount": 0,
"NeedsCopyUp": true,
"NeedsChown": true,
"LockNumber": 19
}
]上面命令一次性输出 mydata 和 db_volume 两个数据卷的完整配置、存储路径、状态等结构化信息。
(3)常用自定义格式
# 1.只显示数据卷的名称和挂载点(最常用)
podman volume inspect -f "{{.Name}} -> {{.Mountpoint}}" mydata
# 实例:
C:\Users\Administrator>podman volume inspect -f "{{.Name}} -> {{.Mountpoint}}" mydata
mydata -> /home/user/.local/share/containers/storage/volumes/mydata/_data
# 2.显示名称、驱动类型、创建时间
podman volume inspect -f "Name: {{.Name}}, Driver: {{.Driver}}, Created: {{.CreatedAt}}" mydata
# 实例:
C:\Users\Administrator> podman volume inspect -f "Name: {{.Name}}, Driver: {{.Driver}}, Created: {{.CreatedAt}}" mydata
Name: mydata, Driver: local, Created: 2025-12-12 17:15:43.092832204 +0800 CSTpodman volume inspect 的默认输出为 JSON 数组(即使查询单个卷),每个数组元素对应一个数据卷的完整信息。以下是典型输出的详细解析(以本地数据卷为例):
[
{
"Name": "mydata", // 数据卷名称(用户指定或自动生成)
"Driver": "local", // 存储驱动(默认 local,支持 nfs/ceph 等)
"Mountpoint": "/var/lib/containers/storage/volumes/mydata/_data", // 宿主机实际存储路径
"CreatedAt": "2024-05-20T10:30:00+08:00", // 数据卷创建时间
"Labels": { // 数据卷标签(创建时通过 --label 添加)
"environment": "prod",
"app": "database"
},
"Scope": "local", // 卷的作用域(local=本地,remote=远程存储)
"Options": { // 驱动选项(创建时通过 --opt 指定的参数)
"o": "uid=1000,gid=1000", // 权限配置(普通用户 UID/GID)
"mountpoint": "/home/user/custom-vol" // 自定义挂载点(若指定)
},
"CreatedBy": "", // 创建该卷的容器 ID(若有,为空表示手动创建)
"UsageData": { // 数据卷使用统计(Podman 4.0+ 支持)
"RefCount": 1, // 引用计数(挂载该卷的容器数量)
"Size": 102400, // 数据卷占用存储空间(字节)
"Inodes": 100 // 索引节点数量(文件/目录个数)
}
}
]各字段核心含义(按重要性排序):
Name 数据卷唯一标识,用于挂载、删除等操作(必须牢记)。
Mountpoint 宿主机上的数据卷实际存储路径,可直接访问该目录操作数据(如手动备份、修改文件)。
Driver 存储驱动类型,判断数据卷是本地存储(local)还是远程存储(nfs/ceph)。
Options 驱动配置参数,包含权限(uid/gid)、挂载选项(rw/ro)、远程存储地址等关键信息。
Labels 数据卷标签,用于分类筛选(如 environment=prod 标记生产环境的卷)。
UsageData 资源占用统计:RefCount 可判断卷是否被占用(>0 表示正在使用),Size 查看存储空间占用。
CreatedAt 创建时间,用于排查 “旧卷清理” 等问题。
Scope 作用域,local 表示仅本地可用,remote 表示跨主机共享(如 NFS 卷)。