docker system df 是 docker 内置命令，用于查看镜像、容器、本地卷和构建缓存的磁盘占用及可回收空间；加 -v 参数可展开明细，配合 prune 系列命令安全清理无用资源。

system df 是 Docker 提供的内置命令，用于查看 Docker 引擎占用的磁盘空间情况，包括镜像、容器、卷和构建缓存等各部分的大小和使用率。它不依赖外部工具，直接反映 Docker 自身数据的存储分布。

查看整体磁盘使用概况

运行以下命令即可获得概览：

• docker system df —— 显示总用量、各类型资源（Images、Containers、Local Volumes、Build Cache）的大小及可回收空间
• 输出中 SIZE 表示当前占用空间，RECLAIMABLE 表示可通过清理释放的空间（如已停止但未删除的容器、悬空镜像、未被引用的构建缓存等）

显示详细信息（含具体对象）

加上 -v（verbose）参数可展开每类资源的明细：

Agent Memory System v12

Agent 记忆系统 — 五路融合检索 + 双时间线 + 因果链 + Spirit管家 + 记忆回声 + 弹性配置 + Circuit Breaker + GDPR合规 + 192项安全审计修复

下载

• docker system df -v
• 例如：在 Images 部分会列出每个镜像 ID、仓库名、标签、大小和是否为悬空（<none></none>）状态；Volumes 部分会显示每个卷名称、驱动、挂载点和实际占用大小
• 注意：卷的实际大小取决于其底层存储驱动（如 local 卷在宿主机路径中的真实文件体积），Docker 仅估算或调用驱动报告，可能与 du -sh 结果略有差异

配合清理命令释放空间

看到 RECLAIMABLE 数值后，可根据需要执行对应清理操作：

• docker system prune —— 删除已停止容器、悬空镜像、未使用的网络和构建缓存（加 -a 可删所有未被使用的镜像）
• docker volume prune —— 单独清理未被任何容器引用的卷（谨慎执行，确认数据已备份）
• docker builder prune —— 清理构建缓存（Docker 20.10+ 支持，对多阶段构建尤其有用）

常见注意事项

使用时需留意几个关键点：

• 该命令统计的是 Docker 管理的数据，不含用户自己在容器内写入但未映射到卷的临时文件（这些属于容器可写层，已计入 Containers SIZE）
• 如果使用 overlay2 存储驱动，部分空间可能因未及时 unmount 或 inode 泄漏而无法准确反映，此时可结合 df -h /var/lib/docker 对照查看
• 非 root 用户需确保有权限执行 docker 命令（通常需加入 docker 用户组）