docker-cleanup为何被弃用现代Docker清理替代方案完整清单【免费下载链接】docker-cleanupDEPRECATED Automatic Docker image, container and volume cleanup项目地址: https://gitcode.com/gh_mirrors/do/docker-cleanupdocker-cleanup 是一款曾经广受欢迎的Docker 清理工具它会自动、定期地清理已退出容器、无用镜像和孤儿数据卷帮助运维人员防止磁盘被撑爆。如今该项目已被官方标记为DEPRECATED弃用不再维护。本文带你快速了解 docker-cleanup 的来龙去脉、被弃用的核心原因并给出一份现代 Docker 清理替代方案完整清单帮助你选择合适的磁盘清理策略 。docker-cleanup 曾经能做什么docker-cleanup 本质是一个基于 Bash 脚本的常驻容器定期扫描每隔一段时间默认 30 分钟见run.sh中CLEAN_PERIOD1800扫描宿主机上的已退出容器、无标签none镜像和孤儿数据卷并自动删除灵活排除通过环境变量KEEP_IMAGES、KEEP_CONTAINERS、KEEP_CONTAINERS_NAMED配置保留清单默认值定义在 env.list 中避免误删关键容器多场景部署支持命令行一键运行、Systemd 服务、Puppet 配置管理还自带 contrib/k8s-daemonset.yml 可以在 Kubernetes 每个节点上以 DaemonSet 方式运行数据卷深度清理核心清理逻辑位于 docker-cleanup-volumes.sh配合挂载宿主机/var/lib/docker目录可连孤儿数据卷一起回收。在 Docker 早期生态中Jenkins 构建节点、高频起停容器的集群节点最容易磁盘爆满docker-cleanup 就是为此而生的磁盘守门员 ️。docker-cleanup 为何被弃用4个关键原因README 顶部已明确标注仓库不再积极维护。结合项目本身可以总结出它被淘汰的四个原因1️⃣ 官方停止维护无安全与版本跟进项目停止更新后无法跟进 Docker 引擎的新特性BuildKit、镜像 GC 等新出现的 Docker 版本行为变化都可能让脚本失效。2️⃣ 依赖旧版 Docker API兼容性差run.sh 默认使用Docker API 1.20约 2017 年水平与近几年的 Docker Engine 版本差距巨大API 字段和行为的不兼容会直接影响清理结果。3️⃣ 机制天然危险挂载 /var/lib/docker 才能清理卷它要清理孤儿数据卷就必须把宿主机的/var/lib/docker整个目录挂载进容器。README 中的 WARNING 也承认如果脚本与系统或 Docker 版本不兼容可能会删除所有数据卷甚至包括运行中容器的卷。这种全权托管的设计在现代实践中风险太高 ⚠️。4️⃣ 纯 Bash 脚本实现可维护性低核心逻辑是模式匹配 docker客户端命令拼接如 run.sh 中的checkPatterns函数随着 Docker 对象模型演进构建缓存、镜像元数据、卷驱动等脚本式实现越来越难维护。现代 Docker 清理替代方案完整清单下面这份清单按从简单到进阶排列覆盖了绝大多数使用场景。方案1docker system prune —— 一键清理最常用一条命令清理已停止容器、无用网络、悬空镜像和构建缓存docker system prune想连未使用的镜像和数据卷一起清理加--all和-v慎用docker system prune --all -v 新手建议先运行不带-v的版本观察结果确认无误后再决定是否清理数据卷。方案2细分清理命令 —— image / container / volume prunedocker system prune 之外的三件套颗粒度更细命令作用常用参数docker image prune清理无用镜像-a清理所有未被容器引用的镜像docker container prune清理已退出容器—docker volume prune清理未使用数据卷高风险执行前务必确认另外别忘了docker builder prune构建缓存往往是磁盘空间的隐形杀手 ️。方案3cron / systemd timer 定时自动清理把清理做成定时任务即可复刻 docker-cleanup 的定期自动清理能力docker system prune -f # 加入 crontab如每天凌晨 3 点执行相比运行一个常驻容器定时任务更轻量、更易排查也不需要把 Docker 目录挂载给第三方容器。方案4Docker Desktop 内置清理设置如果你在 macOS / Windows 上使用 Docker Desktop可以直接在Settings → Resources中开启镜像自动清理Image pruning配合磁盘用量面板随时查看空间占用是本地开发最省心的方案。方案5Kubernetes 节点自动回收kubelet imageGCK8s 用户无需再像当年那样部署 DaemonSet 清理容器kubelet 自带image GC 机制通过image-gc-high-threshold默认 80%和image-gc-low-threshold默认 60%两个参数自动按节点磁盘压力回收未被使用的镜像。这是官方内建机制安全性和稳定性远优于外挂脚本。方案6CI/CD 构建节点缓存清理Jenkins、GitLab CI 等构建节点会持续产生 SNAPSHOT 镜像和构建缓存——这正是当年 docker-cleanup 的典型应用场景。现代做法是Jenkins使用 Docker 相关插件如 Docker Build and Publish内置的容器/镜像回收逻辑通用在构建机上加一条docker system prune -af定时任务或让 CI Runner 使用 container 注册器并在作业结束后自动销毁。如何选择一张对照表看懂使用场景推荐方案个人开发机偶尔手动清理docker system prune方案1本地 Mac / Windows 开发Docker Desktop 内置清理方案4生产服务器长期运行cron / systemd timer 定时任务方案3Kubernetes 集群节点kubelet imageGC docker volume prune巡检方案5CI/CD 构建集群构建缓存清理 定时 prune方案6清理前的 3 条安全建议 ⚠️数据卷最危险volume prune和system prune -v会删除未被使用的卷而业务容器可能只是暂时没有运行。删除前先docker volume ls确认保留清单思维docker-cleanup 的KEEP_IMAGES设计值得借鉴——无论用哪种方案先想清楚哪些镜像/卷绝不能删先演练后执行先在不带-f的情况下预览将删除的内容或用--filter限定范围如只清理 7 天前的对象。总结docker-cleanup 是一个时代的产物它解决了早期 Docker 生态无人自动清理磁盘的痛点但由于停止维护、依赖旧版 Docker API、挂载整个 Docker 目录的高风险机制已不再适合今天的环境。好消息是现代 Docker 生态已经把这些能力内建化——docker system prune三件套、Docker Desktop 自动清理、Kubernetes 的 imageGC加上简单的定时任务就能安全地覆盖它曾经的全部场景。下次磁盘告警时按上文清单对号入座即可 。【免费下载链接】docker-cleanupDEPRECATED Automatic Docker image, container and volume cleanup项目地址: https://gitcode.com/gh_mirrors/do/docker-cleanup创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
