容器与云原生 / 系统课时

删除与清理镜像

删除与清理镜像

镜像清理的关键不是“删得多”,而是先确认哪些空间可回收、哪些镜像仍被容器引用,再从悬空镜像逐步扩大到未使用镜像。按这个顺序操作,可以释放磁盘空间,同时避免误删仍需快速启动或回滚的镜像。

学习目标

  • 区分悬空镜像、未使用镜像和仍被容器引用的镜像
  • 使用 docker image rm 与 docker image prune 安全释放空间
  • 在删除失败时定位容器依赖,并理解强制删除的风险

先确认空间花在哪里

清理前先查看 Docker 磁盘占用。docker system df 会汇总镜像、容器、本地卷和构建缓存;需要更细的镜像共享层信息时,再使用 docker system df -v。

bash
docker system df

预期输出

text
TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          <VALUE>   <VALUE>   <VALUE>   <VALUE>
Containers      <VALUE>   <VALUE>   <VALUE>   <VALUE>
Local Volumes   <VALUE>   <VALUE>   <VALUE>   <VALUE>
Build Cache     <VALUE>   <VALUE>   <VALUE>   <VALUE>

实际数量和大小会因本机环境不同。优先关注 RECLAIMABLE,它比镜像列表中的大小总和更接近真正可释放的空间,因为多个镜像可能共享同一层。

处理悬空镜像

悬空镜像通常是没有标签、且没有容器引用的旧构建结果,列表中常显示为 <none>:<none>。先列出再清理,比直接执行大范围删除更容易确认影响。

bash
docker image ls --filter dangling=true
docker image prune -f

预期输出

text
REPOSITORY   TAG       IMAGE ID       CREATED       SIZE
<none>       <none>    <ID>           <TIME>        <VALUE>
Deleted Images:
deleted: sha256:<ID>
Total reclaimed space: <VALUE>

如果当前没有悬空镜像,删除列表可能为空,并显示 Total reclaimed space: 0B。docker image prune 默认只处理悬空镜像,不会等价于删除所有未使用镜像。

清理未使用镜像

需要扩大范围时,可以使用 -a 删除没有任何容器关联的镜像。生产或共享开发机上建议再加时间过滤,给近期构建和回滚镜像保留缓冲区。

bash
docker image prune -a --filter "until=168h" -f

预期结果

text
Deleted Images:
<可能为空,或列出一个或多个已删除镜像>
Total reclaimed space: <VALUE>

这里的 168h 表示 7 天。该命令只考虑符合时间条件且未被容器使用的镜像,但仍可能删除你计划用于离线回滚、预热或稍后启动的镜像,因此执行前应确认这些镜像是否需要保留。

遇到依赖冲突时怎么做

删除指定镜像前,可以先查找引用它的容器。把 <IMAGE> 替换为镜像 ID 或 仓库:标签;如果停止容器仍引用该镜像,而你尝试删除其最后一个标签或镜像 ID,Docker 会阻止删除。

bash
docker ps -a --filter ancestor=<IMAGE> --format '{{.ID}}\t{{.Status}}\t{{.Names}}'
docker image rm <IMAGE>

预期结果

text
<ID>    Exited (<VALUE>) <TIME> ago    <NAME>
Error response from daemon: conflict: unable to delete <ID> ... image is being used by stopped container <ID>

错误文本会随 Docker 版本略有差异,但核心信息是镜像仍被某个容器引用。此时先判断容器是否还需要;确认可删除后,移除对应容器,再重新执行 docker image rm <IMAGE>。

bash
docker rm <CONTAINER_ID>
docker image rm <IMAGE>

预期结果

text
<CONTAINER_ID>
Untagged: <IMAGE>
Deleted: sha256:<ID>

若同一镜像仍有其他标签或共享层被其他镜像引用,输出可能只显示 Untagged,部分层也不会被实际删除。不要为了绕过依赖检查直接习惯性使用 docker image rm -f,因为强制操作会让现有容器与镜像标签关系更难判断。

什么时候使用 system prune

docker system prune 会同时处理停止的容器、未使用网络、悬空镜像和部分构建缓存;加 -a 后镜像范围更大。它适合一次性清理实验机或 CI 节点,但影响面明显大于 docker image prune。

bash
docker system prune -a -f

预期输出

text
Deleted Containers:
<可能为空或列出容器 ID>
Deleted Images:
<可能为空或列出镜像>
Total reclaimed space: <VALUE>

本地卷默认不会因为这条命令被删除;只有显式增加 --volumes 才会扩大到未使用卷。安全的长期习惯是先用 docker system df 确认回收目标,再从 docker image prune 开始,只有确实需要跨资源清理时才升级到 docker system prune。

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

目录与阅读设置

阅读设置

17

记录一个想法

删除与清理镜像

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

登录哪都通