容器与云原生 / 系统课时

检查磁盘占用

检查磁盘占用

本课使用 Docker 自带命令统计镜像、容器、数据卷和构建缓存的空间占用,再结合宿主机目录检查定位异常日志或可写层,最终判断哪些内容可以清理、哪些数据必须保留。

学习目标

  • 读懂 docker system df 中的总量、活动量和可回收空间
  • 定位大镜像、大容器写入层、数据卷及日志目录
  • 按风险顺序执行清理并复查磁盘变化

先查看 Docker 空间汇总

docker system df 给出四类对象的汇总,-v 会展开到具体镜像、容器、卷和构建缓存。先看 RECLAIMABLE,再检查对应对象是否仍被业务使用,不要只依据 SIZE 决定删除。

bash
docker system df
docker system df -v

预期输出会包含以下结构,数量和容量取决于当前主机:

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

Images space usage:
REPOSITORY   TAG     IMAGE ID       CREATED       SIZE      SHARED SIZE   UNIQUE SIZE   CONTAINERS
<IMAGE>      <TAG>   <IMAGE_ID>     <TIME>        <SIZE>    <SIZE>        <SIZE>        <N>

ACTIVE 表示对象仍被现有容器引用。镜像的共享层会被多个镜像复用,因此各行 SIZE 直接相加可能重复计算;判断实际可释放空间时,应以汇总中的 RECLAIMABLE 和清理后的复查结果为准。

定位大容器、日志与 Docker 根目录

容器的 SIZE 主要表示可写层,不包含挂载卷的全部数据。日志文件也可能快速增长,因此在 Linux 主机上还应检查 Docker 根目录及 *-json.log 文件。以下命令只读取信息,不会删除对象。

bash
docker ps -a --size \
  --format 'table {{.Names}}\t{{.Status}}\t{{.Size}}'

DOCKER_ROOT=$(docker info --format '{{.DockerRootDir}}')
sudo du -xh --max-depth=1 "$DOCKER_ROOT" | sort -h

sudo find "$DOCKER_ROOT/containers" \
  -type f -name '*-json.log' \
  -printf '%s %p\n' |
  sort -n |
  tail -10

预期输出会先列出容器可写层,再显示 Docker 根目录各子目录和最大的 JSON 日志文件:

text
NAMES          STATUS          SIZE
<CONTAINER>    Up <TIME>       <SIZE> (virtual <SIZE>)

<SIZE>  <DOCKER_ROOT>/containers
<SIZE>  <DOCKER_ROOT>/overlay2
<SIZE>  <DOCKER_ROOT>/volumes
<SIZE>  <DOCKER_ROOT>

<BYTES> <DOCKER_ROOT>/containers/<ID>/<ID>-json.log

若 overlay2 很大,通常需要回到镜像、停止容器和构建缓存继续分析;若单个 JSON 日志异常大,应配置日志轮转,而不是长期手工清空文件。Docker Desktop 不直接暴露相同的宿主机目录,此时以 docker system df -v 和桌面端磁盘管理信息为准。

判断哪些空间可以回收

镜像只有在没有任何容器引用时才可被镜像清理命令删除;停止的容器仍会引用其镜像。数据卷即使显示为未使用,也可能保存人工备份或待恢复数据,删除前必须通过 docker volume inspect <VOLUME> 确认来源和用途。

对象 常见可回收条件 主要风险
停止容器 已确认不再回滚或排查 丢失容器可写层中的临时文件
未使用镜像 无容器引用且可重新拉取或构建 回滚时需要重新下载或构建
构建缓存 旧构建结果可重新生成 下一次构建耗时增加
未使用卷 已有备份且确认无业务依赖 可能永久删除数据库或上传文件

容器日志、绑定挂载目录和 Docker 之外的备份文件不一定计入 docker system df。因此宿主机磁盘告警与 Docker 汇总不一致时,应继续使用 du 检查 Docker 根目录及应用绑定目录。

按风险顺序清理并复查

完成对象核对后,可先清理七天前创建的停止容器,再清理未被容器引用的旧镜像和构建缓存。until=168h 是时间过滤条件,不代表对象最近七天没有被访问;执行前仍需人工确认命令列出的影响范围。

bash
docker container prune --filter "until=168h"
docker image prune -a --filter "until=168h"
docker builder prune --filter "until=168h"
docker system df

每个清理命令都会先要求确认,接受后列出删除对象并汇总释放空间,最后一次统计应显示占用下降:

text
WARNING! This will remove <OBJECT_DESCRIPTION>.
Are you sure you want to continue? [y/N] y
Deleted <OBJECT_TYPE>:
<ID>

Total reclaimed space: <SIZE>

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

不要在常规清理中直接附加 --volumes。卷删除应单独审批、先备份再执行,并在清理后启动关键服务验证镜像拉取、数据挂载和日志输出是否正常。

本课总结

  • docker system df -v 用于定位 Docker 对象,宿主机 du 用于补充检查日志和实际目录
  • SIZE 不等于可释放空间,清理决策应结合引用关系与 RECLAIMABLE
  • 清理应从停止容器、未使用镜像和构建缓存开始,数据卷必须单独确认

下一课预告

下一课可以继续围绕容器应用排查,结合日志、健康检查和资源指标定位服务启动失败、反复重启或响应缓慢的问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

检查磁盘占用

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

登录哪都通