直接运行 docker image prune -a 可一键清理所有未被任何容器（含已停止）引用的本地镜像，需输入 y 确认；加 -f 可跳过确认强制执行，但需谨慎避免误删。

直接运行 docker image prune -a 即可一键清理所有未被容器（包括已停止的容器）引用的本地镜像。

确认哪些镜像会被删除

该命令默认不会真正删除，而是先列出将被清除的镜像，等待你输入 y 确认。若想跳过交互、直接执行，加 -f 参数：

• docker image prune -a -f —— 强制清理，不提示
• 注意：-a 表示“all”，即清理所有未被任何容器（无论运行中或已退出）使用的镜像；不加 -a 则只清理“悬空镜像”（dangling，即没有标签且未被引用的镜像）

避免误删正在使用的镜像

Docker 本身有保护机制：只要某个镜像被任一容器（哪怕是已停止的）作为基础镜像引用，就不会被 prune -a 删除。例如：

• 你用 nginx:alpine 启动过一个容器，即使它已 stop，该镜像也不会被清理
• 只有彻底 docker rm 掉所有依赖它的容器后，再运行 prune -a，它才会进入待删列表

配合其他清理一起释放磁盘空间

单清镜像往往不够，建议组合使用：

• docker system prune -a -f —— 清理未使用的镜像 + 悬空构建缓存 + 未使用的网络 + 所有已停止容器
• 如需额外清理构建缓存，可单独加 --filter until=24h 等条件限制时间范围
• 执行后可用 docker system df 查看实际释放的空间

安全提醒

镜像一旦删除无法自动恢复，操作前建议：

• 用 docker images 和 docker ps -a 对照检查关键镜像是否仍有容器关联
• 对重要镜像，提前 docker save -o backup.tar 镜像名 备份
• 生产环境避免在无备份情况下直接 -f 强制执行