容器与云原生 / 系统课时
检查磁盘占用
检查磁盘占用
本课使用 Docker 自带命令统计镜像、容器、数据卷和构建缓存的空间占用,再结合宿主机目录检查定位异常日志或可写层,最终判断哪些内容可以清理、哪些数据必须保留。
学习目标
- 读懂
docker system df中的总量、活动量和可回收空间 - 定位大镜像、大容器写入层、数据卷及日志目录
- 按风险顺序执行清理并复查磁盘变化
先查看 Docker 空间汇总
docker system df 给出四类对象的汇总,-v 会展开到具体镜像、容器、卷和构建缓存。先看 RECLAIMABLE,再检查对应对象是否仍被业务使用,不要只依据 SIZE 决定删除。
docker system df
docker system df -v预期输出会包含以下结构,数量和容量取决于当前主机:
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 文件。以下命令只读取信息,不会删除对象。
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 日志文件:
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 是时间过滤条件,不代表对象最近七天没有被访问;执行前仍需人工确认命令列出的影响范围。
docker container prune --filter "until=168h"
docker image prune -a --filter "until=168h"
docker builder prune --filter "until=168h"
docker system df每个清理命令都会先要求确认,接受后列出删除对象并汇总释放空间,最后一次统计应显示占用下降:
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- 清理应从停止容器、未使用镜像和构建缓存开始,数据卷必须单独确认
下一课预告
下一课可以继续围绕容器应用排查,结合日志、健康检查和资源指标定位服务启动失败、反复重启或响应缓慢的问题。