docker-cleanup部署指南用Systemd构建Linux服务器定时自动清理服务【免费下载链接】docker-cleanupDEPRECATED Automatic Docker image, container and volume cleanup项目地址: https://gitcode.com/gh_mirrors/do/docker-cleanupdocker-cleanup 是一个开源的Docker 自动清理工具它会周期性扫描 Linux 服务器自动清理已退出的容器、无人使用的镜像和孤立的卷专门解决Docker 越用越多、磁盘空间被悄悄占满这一常见痛点。本文将带你从零完成 docker-cleanup 部署先用一条命令快速试用再用 Systemd 把它变成开机自启、定时运行的后台清理服务。⚠️使用提示该项目目前标记为 DEPRECATED不再活跃维护核心思路依然实用生产环境部署前请仔细阅读后文的安全注意事项。如果你使用的是较新版本 Docker也可以先了解官方自带的docker system prune命令作为对照。为什么需要 Docker 自动清理工具在 Linux 服务器上长期运行 Docker磁盘膨胀几乎是必然的已退出容器堆积容器退出后默认仍保留在磁盘上需要手动docker rm才能移除旧版本镜像残留不断升级应用后旧镜像一直躺在仓库里未标记镜像泛滥Jenkins 构建节点、CI 集群上反复构建会留下大量none幽灵镜像孤立卷膨胀容器删除时未加-v数据卷会一直保留。docker-cleanup 的清理逻辑由 run.sh 实现它按轮询循环依次执行清理未使用的卷 → 删除已退出/死亡容器 → 移除无用镜像整个过程全自动、无需人工值守。第一步一条命令快速试用 docker-cleanup部署前先手动跑一次确认清理行为符合预期。由于脚本通过 Docker 客户端命令操作宿主机必须挂载 Docker 套接字docker run \ -v /var/run/docker.sock:/var/run/docker.sock:rw \ -v /var/lib/docker:/var/lib/docker:rw \ meltwater/docker-cleanup:latest⚠️ 注意第二条挂载一旦映射/var/lib/docker脚本还会连带清理孤立的 Docker 卷。只试清理容器和镜像时可以只挂第一条。运行一次后观察输出看到类似Done! X images and Y layers have been cleaned的提示说明工作正常。第二步用 Systemd 构建定时自动清理服务想让它无人值守最佳实践是把 docker-cleanup 注册为 Systemd 服务实现开机自启 崩溃自动重启 按固定周期循环清理。1. 创建 Systemd 服务单元文件在/etc/systemd/system/docker-cleanup.service写入以下内容参考官方 README 提供的模板[Unit] DescriptionCleanup of exited containers and unused images/volumes Afterdocker.service Requiresdocker.service [Install] WantedBymulti-user.target [Service] EnvironmentIMAGEmeltwater/docker-cleanup:latest NAMEdocker-cleanup # Allow docker pull to take some time TimeoutStartSec600 # Restart on failures KillModenone Restartalways RestartSec15 ExecStartPre-/usr/bin/docker kill $NAME ExecStartPre-/usr/bin/docker rm $NAME ExecStartPre-/bin/sh -c if ! docker images | tr -s : | grep ^${IMAGE}:; then docker pull ${IMAGE}; fi ExecStart/usr/bin/docker run \ -v /var/run/docker.sock:/var/run/docker.sock:rw \ -v /var/lib/docker:/var/lib/docker:rw \ --name${NAME} \ $IMAGE ExecStop/usr/bin/docker stop $NAME这段配置的几个要点RestartalwaysRestartSec15服务异常退出后 15 秒自动拉起保证清理任务长期存活ExecStartPre三条命令启动前先清理同名旧容器并检查本地镜像、缺失时自动拉取避免重复docker pullAfterdocker.serviceRequiresdocker.service确保 Docker 引擎先于清理服务启动。2. 启用并启动服务sudo systemctl daemon-reload # 重新加载单元文件 sudo systemctl enable docker-cleanup # 设置开机自启 sudo systemctl start docker-cleanup # 立即启动3. 验证服务状态systemctl status docker-cleanup # 查看服务是否 running journalctl -u docker-cleanup -f # 实时查看清理日志日志里会周期性出现Run the clean script every 1800 seconds and delay 1800 seconds to clean这样的提示说明定时循环已生效。第三步用环境变量微调清理策略所有参数都可以通过环境变量覆盖在 Systemd 单元的Environment中添加即可完整清单见 Dockerfile 和 env.list变量默认值作用CLEAN_PERIOD1800两轮清理之间的间隔秒默认 30 分钟DELAY_TIME1800扫描完成到真正删除前的缓冲等待秒避免误删正在操作的对象KEEP_IMAGES空需要豁免的镜像列表如ubuntu:trusty, ubuntu:latestKEEP_CONTAINERS空需要豁免的容器镜像列表KEEP_CONTAINERS_NAMED空需要豁免的容器名称列表LOOPtrue设为false则只清理一次就退出适合配合 crontab 使用DEBUG0设为 1 输出匹配调试信息DOCKER_API_VERSION1.20Docker API 版本可用docker version查看宿主机版本后覆盖两个实用技巧排除重要资源把不允许被删的镜像加入白名单例如EnvironmentKEEP_IMAGESmysql:8.0,redis:latest。白名单使用左锚定的 shell 模式匹配不是正则foo/bar:tag会被foo/bar、*:tag等模式匹配到全量保镜像若想完全跳过镜像清理用KEEP_IMAGES*:*注意不要只用*那会被当作文件名匹配。安全注意事项部署前必读挂载/var/lib/docker风险最高这会开启卷清理清理脚本会直接操作宿主机 Docker 数据目录。官方警告若与你的系统或 Docker 版本不兼容极端情况下可能误删卷数据生产环境请务必先备份或先在测试机验证只清理退出状态运行中容器不受影响但已退出容器中的数据会随docker rm -v一并删除需要保留现场排查的容器请用KEEP_CONTAINERS_NAMED排除项目已停止维护对 Docker 1.13 以上版本卷清理自动改用原生docker volume rm更老的版本走 docker-cleanup-volumes.sh基于 chadoe 的清理脚本见 docker-cleanup-volumes-LICENSE.md保留退出缓冲DELAY_TIME是重要的安全阀不建议设为 0防止刚扫描就删除撞上正在拉取镜像的操作。其他部署方式除了 Systemd项目还支持两种常见场景Kubernetes 集群DaemonSet 全节点部署仓库提供了 contrib/k8s-daemonset.yml让每个集群节点都运行一个清理容器内置CLEAN_PERIOD60、DELAY_TIME1800的环境变量配置kubectl create -f contrib/k8s-daemonset.yml从源码构建镜像如果想基于源码二次开发例如修改轮询逻辑可以克隆仓库后用自带的 Makefile 构建git clone https://gitcode.com/gh_mirrors/do/docker-cleanup cd docker-cleanup make build # 构建 meltwater/docker-cleanup 镜像Makefile 还提供了make run、make restart、make int进入容器调试等常用命令运行make help可查看完整菜单。常见问题速查Q如何只清理一次而不常驻设置LOOPfalse脚本完成一轮清理后自行退出配合 crontab 即可实现每天凌晨清一次的效果。Q如何确认某个镜像/容器为什么没被删设置DEBUG1日志会打印每个对象的模式匹配过程Matches ... keeping/No match。Q如何临时停止自动清理sudo systemctl stop docker-cleanup彻底卸载则再执行sudo systemctl disable docker-cleanup并删除单元文件。总结步骤命令/操作目的试用docker run -v /var/run/docker.sock:...验证清理效果部署创建/etc/systemd/system/docker-cleanup.service开机自启 崩溃自恢复调参CLEAN_PERIOD/KEEP_IMAGES等环境变量定制清理周期与白名单验证journalctl -u docker-cleanup -f跟踪清理日志docker-cleanup 的精髓在于挂载 Docker 套接字 循环清理的极简设计配合 Systemd 只需不到 20 行配置就能让 Linux 服务器的磁盘空间始终保持健康。即使项目已停止维护这套方案依然是搭建 Docker 定时自动清理服务的经典参考。【免费下载链接】docker-cleanupDEPRECATED Automatic Docker image, container and volume cleanup项目地址: https://gitcode.com/gh_mirrors/do/docker-cleanup创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考