容器与云原生 / 系统课时

怎样查看 Docker 磁盘占用

怎样查看 Docker 磁盘占用

宿主机出现磁盘告警时,先不要凭目录大小猜测该删什么。docker system df 能按镜像、容器、卷和构建缓存汇总 Docker 管理的数据,再用详细模式定位具体对象,从而判断真正值得优先处理的资源类型。

学习目标

  • 会使用 docker system df 查看 Docker 磁盘占用汇总
  • 能理解 TOTAL、ACTIVE、SIZE 与 RECLAIMABLE 的含义
  • 能根据详细统计判断应优先检查镜像、容器、卷还是构建缓存

先看 Docker 自己的汇总

先执行只读统计命令,它不会删除任何资源。

bash
docker system df

预期输出的结构类似下面这样,数量和容量会随主机实际状态变化:

text
TYPE            TOTAL       ACTIVE      SIZE        RECLAIMABLE
Images          <COUNT>     <COUNT>     <SIZE>      <SIZE> (<PERCENT>%)
Containers      <COUNT>     <COUNT>     <SIZE>      <SIZE> (<PERCENT>%)
Local Volumes   <COUNT>     <COUNT>     <SIZE>      <SIZE> (<PERCENT>%)
Build Cache     <COUNT>     <COUNT>     <SIZE>      <SIZE>

TOTAL 是该类对象总数,ACTIVE 表示仍被相关对象引用或使用的数量,SIZE 是 Docker 统计到的空间占用,RECLAIMABLE 是 Docker 估算可回收的空间。它适合确定方向,但不应把可回收值理解成“执行一次清理后必然释放的精确字节数”,因为镜像层可能被共享。

用详细模式定位大户

如果汇总显示某一类资源占用明显偏高,再查看对象级明细。

bash
docker system df -v

预期结果会按资源类别展开;例如镜像部分会出现类似字段:

text
Images space usage:

REPOSITORY      TAG       IMAGE ID    CREATED    SIZE      SHARED SIZE   UNIQUE SIZE   CONTAINERS
<REPOSITORY>    <TAG>     <ID>        <AGE>      <SIZE>    <SIZE>        <SIZE>        <COUNT>

镜像的 SHARED SIZE 是与其他镜像共用的层,UNIQUE SIZE 才是该镜像独占的部分。因此,一个看起来很大的镜像并不等于删除后就能释放同等空间。详细模式还会列出容器、Local Volumes 和构建缓存等信息,便于继续定位。

根据统计决定先查什么

现象 优先检查 判断重点
Images 的 RECLAIMABLE 很高 未使用镜像 是否仍需要旧版本做回滚,是否只是共享层导致表面很大
Containers 占用较高 已停止容器 容器可写层里是否留有临时文件或需要保留的数据
Local Volumes 占用较高 Docker 卷 是否保存数据库、上传文件等持久化数据,不能只看“未运行”就删除
Build Cache 占用较高 构建缓存 是否可以牺牲后续构建速度换取磁盘空间

排查时应从占用最大的类别开始,再确认对象是否仍有业务价值。这样比直接运行全局清理命令更可控,也更容易解释释放空间来自哪里。

看懂 Docker 统计的边界

docker system df 关注 Docker daemon 管理的资源,并不能解释宿主机上的全部磁盘占用。例如 bind mount 指向的宿主机目录属于普通文件系统数据,仍要结合 df -h、目录容量和日志策略排查。

不要为了“让数字变小”直接删除 Docker 数据目录中的文件。先用 Docker 自己的统计确定资源类型,再使用对应的镜像、容器、卷或构建缓存管理命令处理,才能避免破坏 Docker 的元数据和业务数据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

怎样查看 Docker 磁盘占用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通