marcopeg/docker-vacuum

Docker Vacuum

镜像概述

Docker Vacuum是一个实用容器工具，旨在帮助你在生产服务器或开发机器上保持Docker环境的整洁。它通过程序化方式清理系统，删除未使用的镜像，并基于标签设置保留策略。

核心功能

• 按自定义规则保留指定数量的最新镜像
• 支持设置首次运行延迟，避免启动时的竞争条件
• 可配置定期清理间隔
• 可选执行Docker系统级清理（包括卷清理）

使用场景

• 生产服务器：自动清理过时镜像，释放存储空间
• 开发机器：定期整理本地Docker镜像，避免占用过多磁盘资源

配置说明

可通过环境变量自定义工具行为，参考 .env.example 了解配置方式：

VACUUM_DELAY

容器启动后首次运行的延迟时间（毫秒）。
用于给现有容器启动留出时间，避免因启动时的竞争条件导致关联镜像或卷被误删。
默认值：10分钟（600000毫秒）

VACUUM_INTERVAL

清理操作的间隔时间（毫秒）。
默认值：10分钟（600000毫秒）

VACUUM_RULES

JSON格式的规则列表，用于定制镜像保留计划。每个规则包含：

• match：正则表达式，匹配目标镜像名称
• retain：保留的最新标签数量

默认规则：保留所有镜像的最后2个版本。

示例（JSON）：

json
[
  {"match": "(.*)", "retain": 2},
  {"match": "something-(.*)", "retain": 0}
]

示例（BASH）：

bash
VACUUM_RULES="[{\"match\":\"(.*)\",\"retain\":2},{\"match\":\"something-(.*)\",\"retain\":0}]"

VACUUM_SYSTEM_PRUNE

是否执行 docker system prune 操作。
默认值：false（禁用）
启用方式：VACUUM_SYSTEM_PRUNE=true

VACUUM_SYSTEM_PRUNE_VOLUMES

是否清理所有未使用的卷。
默认值：false（禁用）
启用方式：VACUUM_SYSTEM_PRUNE_VOLUMES=true

部署示例

bash
docker run --rm \
--name docker-vacuum \
-e VACUUM_RULES="[{\"match\":\"(.*)\",\"retain\":1}]" \
-e VACUUM_DELAY=1000 \
-v /var/run/docker.sock:/var/run/docker.sock \
marcopeg/docker-vacuum

协作

欢迎提交 https://github.com/marcopeg/docker-vacuum/issues 和 https://github.com/marcopeg/docker-vacuum/pulls%E3%80%82