容器与云原生 / 系统课时
删除与清理镜像
删除与清理镜像
镜像清理的关键不是“删得多”,而是先确认哪些空间可回收、哪些镜像仍被容器引用,再从悬空镜像逐步扩大到未使用镜像。按这个顺序操作,可以释放磁盘空间,同时避免误删仍需快速启动或回滚的镜像。
学习目标
- 区分悬空镜像、未使用镜像和仍被容器引用的镜像
- 使用
docker image rm与docker image prune安全释放空间 - 在删除失败时定位容器依赖,并理解强制删除的风险
先确认空间花在哪里
清理前先查看 Docker 磁盘占用。docker system df 会汇总镜像、容器、本地卷和构建缓存;需要更细的镜像共享层信息时,再使用 docker system df -v。
docker system df预期输出
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>。先列出再清理,比直接执行大范围删除更容易确认影响。
docker image ls --filter dangling=true
docker image prune -f预期输出
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 删除没有任何容器关联的镜像。生产或共享开发机上建议再加时间过滤,给近期构建和回滚镜像保留缓冲区。
docker image prune -a --filter "until=168h" -f预期结果
Deleted Images:
<可能为空,或列出一个或多个已删除镜像>
Total reclaimed space: <VALUE>这里的 168h 表示 7 天。该命令只考虑符合时间条件且未被容器使用的镜像,但仍可能删除你计划用于离线回滚、预热或稍后启动的镜像,因此执行前应确认这些镜像是否需要保留。
遇到依赖冲突时怎么做
删除指定镜像前,可以先查找引用它的容器。把 <IMAGE> 替换为镜像 ID 或 仓库:标签;如果停止容器仍引用该镜像,而你尝试删除其最后一个标签或镜像 ID,Docker 会阻止删除。
docker ps -a --filter ancestor=<IMAGE> --format '{{.ID}}\t{{.Status}}\t{{.Names}}'
docker image rm <IMAGE>预期结果
<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>。
docker rm <CONTAINER_ID>
docker image rm <IMAGE>预期结果
<CONTAINER_ID>
Untagged: <IMAGE>
Deleted: sha256:<ID>若同一镜像仍有其他标签或共享层被其他镜像引用,输出可能只显示 Untagged,部分层也不会被实际删除。不要为了绕过依赖检查直接习惯性使用 docker image rm -f,因为强制操作会让现有容器与镜像标签关系更难判断。
什么时候使用 system prune
docker system prune 会同时处理停止的容器、未使用网络、悬空镜像和部分构建缓存;加 -a 后镜像范围更大。它适合一次性清理实验机或 CI 节点,但影响面明显大于 docker image prune。
docker system prune -a -f预期输出
Deleted Containers:
<可能为空或列出容器 ID>
Deleted Images:
<可能为空或列出镜像>
Total reclaimed space: <VALUE>本地卷默认不会因为这条命令被删除;只有显式增加 --volumes 才会扩大到未使用卷。安全的长期习惯是先用 docker system df 确认回收目标,再从 docker image prune 开始,只有确实需要跨资源清理时才升级到 docker system prune。