默认只删 dangling 镜像(无标签且无容器引用),不删有标签但未被使用的镜像;需加 -a 参数才能清理所有未被容器(含已停止)引用的镜像。

docker image prune 为什么没删掉所有“无用”镜像
默认情况下 docker image prune 只清理 dangling 镜像(即没有标签、且不被任何容器引用的镜像),不是“未被使用的镜像”。很多用户误以为它会删掉所有没在运行的镜像,结果发现磁盘空间几乎没变。
常见错误现象:docker images 显示大量 <none></none> 镜像,但 docker image prune 后仍有大量带标签的旧镜像残留。
- 真正想清理历史构建残留?得加
-a参数:docker image prune -a - 加
-a后会提示确认,加-f跳过:docker image prune -af - 注意:
-a会删掉所有未被任何容器(包括已停止的)引用的镜像,哪怕它有 tag
清理前必须确认哪些镜像还在被使用
误删正在被停止容器依赖的镜像,会导致后续 docker start 失败(报错 No such image)。Docker 不会在 prune -a 时主动检查“停止容器是否依赖该镜像”,只看“是否有容器正引用它”——而停止的容器仍算作引用者。
所以关键不是“有没有运行中容器”,而是“有没有容器对象存在”。验证方式:
- 列出所有容器(含已停止):
docker ps -a - 查某镜像 ID 是否被任何容器使用:
docker ps -a --filter ancestor=<image_id> --format "{{.ID}}"</image_id> - 更安全的做法:先
docker container prune清掉所有已停止容器,再执行image prune -a
docker system prune 是最省事但也最危险的组合命令
docker system prune 会同时清理:停止的容器、dangling 镜像、未被容器使用的网络、构建缓存。但它默认不碰带 tag 的镜像——除非加 -a。
典型误操作:docker system prune -a 会删掉所有未被任何容器(无论运行/停止)引用的镜像 + 所有构建缓存 + 所有未被容器使用的网络。它比单独 image prune -a 影响面更大。
- 构建缓存一删,下次
docker build就全量重新拉 base 镜像、重跑每层指令 - 如果用了 BuildKit(
DOCKER_BUILDKIT=1),缓存位置和行为不同,system prune仍会清掉它 - 生产环境 CI 机器慎用
-a,尤其当有定时构建任务依赖本地缓存加速时
清理后空间没释放?可能是 overlay2 元数据没刷新
Docker 使用 overlay2 存储驱动时,删掉镜像后,/var/lib/docker/overlay2 下对应目录可能仍存在(状态为 “removed”),但磁盘空间不会立刻归还给宿主机——Linux 的 ext4/xfs 不会自动回收被删除但仍有进程打开的文件句柄。
这不是 Docker bug,是内核行为。排查方法:
- 看实际占用:
du -sh /var/lib/docker/overlay2/* | sort -hr | head -5 - 检查是否有残留句柄:
lsof +D /var/lib/docker/overlay2 | grep deleted - 最稳妥解法:重启 docker daemon(
systemctl restart docker),让所有 dangling layer 句柄关闭
这个点最容易被忽略——你明明删了几个 G 的镜像,df 却显示可用空间没变。


















