容器与云原生 / 系统课时

删除无用镜像

删除无用镜像

本篇解决 Docker 主机中镜像越积越多的问题:先安全删除指定镜像,再清理悬空镜像,并在镜像仍被容器引用时按正确顺序解除依赖,避免误删正在使用的资源。

学习目标

  • 使用镜像名称、标签或镜像 ID 删除指定镜像
  • 批量清理悬空镜像,并理解 -a 的影响范围
  • 处理“镜像被容器引用”导致的删除失败

先确认要删除的镜像

删除前先查看镜像列表和磁盘占用,重点核对仓库名、标签、镜像 ID 与大小。不要仅凭创建时间判断镜像是否无用,因为旧镜像仍可能被现有容器引用。

bash
docker image ls
docker system df

预期输出

text
REPOSITORY   TAG       IMAGE ID       CREATED        SIZE
alpine       3.20      <IMAGE_ID>      <TIME>         <SIZE>

TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          <N>       <N>       <SIZE>    <SIZE>

<IMAGE_ID>、<TIME>、<SIZE> 和数量会随本机环境变化。

删除指定镜像

docker rmi 与 docker image rm 等价。推荐使用“仓库名:标签”删除明确版本,避免只写仓库名时误以为会删除全部标签。

bash
docker image rm alpine:3.20

预期输出

text
Untagged: alpine:3.20
Deleted: sha256:<IMAGE_ID>

如果同一个镜像 ID 还绑定其他标签,Docker 可能只删除当前标签而保留镜像层;只有最后一个引用被移除后,相关镜像层才可能真正释放空间。

批量清理无用镜像

悬空镜像通常显示为 <none>:<none>,常见于重复构建后旧标签被新镜像替换。下面的命令只清理悬空镜像,适合作为日常维护操作。

bash
docker image prune -f

预期输出

text
Deleted Images:
deleted: sha256:<IMAGE_ID>

Total reclaimed space: <SIZE>

若使用 docker image prune -a -f,会删除所有未被任何容器使用的镜像,而不只是悬空镜像。执行前应确认这些镜像不再需要,否则下次启动容器时必须重新拉取。

Tips:生产服务器优先执行不带 -a 的清理命令,再结合 docker system df 判断是否需要进一步回收空间。

处理镜像被容器引用

只要存在基于某镜像创建的容器,即使容器已经停止,Docker 也可能拒绝删除镜像。正确顺序是先找到引用它的容器,确认无用后删除容器,再删除镜像。

bash
docker ps -a --filter ancestor=alpine:3.20
docker rm temp-alpine
docker image rm alpine:3.20

预期输出

text
CONTAINER ID   IMAGE         COMMAND     CREATED   STATUS    NAMES
<ID>           alpine:3.20   "<COMMAND>" <TIME>    Exited    temp-alpine
temp-alpine
Untagged: alpine:3.20
Deleted: sha256:<IMAGE_ID>

如果容器仍在运行,先执行 docker stop <ID>,再执行 docker rm <ID>。虽然 docker image rm -f 可以强制移除标签,但它不会替你安全处理容器依赖,日常运维不应把强制删除作为首选方案。

验证清理结果

再次查询镜像列表与磁盘占用,确认目标镜像已经消失,并检查可回收空间是否减少。

bash
docker image ls
docker system df

预期结果

text
目标镜像或悬空镜像不再出现在列表中,Images 的 SIZE 或 RECLAIMABLE 数值相应下降。

本课总结

  • 删除指定镜像优先使用明确的“仓库名:标签”,并在执行前核对镜像列表。
  • docker image prune 清理悬空镜像,增加 -a 后范围会扩大到全部未被容器使用的镜像。
  • 镜像被引用时,应先停止并删除相关容器,再删除镜像。

下一课预告

下一课将学习如何从镜像创建并运行容器,并区分前台运行、后台运行与退出后自动删除等常用模式。

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

目录与阅读设置

阅读设置

17

记录一个想法

删除无用镜像

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

登录哪都通