项目介绍
PruneMate 提供 Docker 资源清理界面和定时任务,帮助查看闲置镜像、容器、网络与卷。清理的关键是确认哪些资源仍用于恢复或回滚,不能只看可释放空间的数字。
面板展示可清理资源并安排任务,但闲置资源也可能用于回滚或临时停用项目。卷是否可删必须与应用数据对应。
适合希望整理 Docker 占用的用户。初次只处理已确认无用的镜像,自动卷清理保持关闭。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 资源查看 | 区分镜像容器网络与卷 |
| 范围选择 | 限定清理对象 |
| 手动清理 | 先验证小范围操作 |
| 任务计划 | 按需设置低频执行 |
| 日志记录 | 保留删除明细 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。

项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | NAS 与运维 |
| 项目仓库 | 0x20Fearless/prunemate |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 在 NAS 创建
/volume1/docker/prunemate/config和logs两个目录,把下面配置保存为项目。先只允许局域网访问管理端口。 - 打开
http://NAS_IP:7676,检查资源列表和清理范围。首次操作只选择确认不用的悬空镜像,保留近期可回滚版本。 - 清理前用
docker system df -v查看明细,把卷名与应用配置逐一对应;暂不启用自动清理卷。 - 确认手动清理结果和日志后,再配置低频计划;调整计划时同步检查新安装应用使用的卷与标签。
首次使用与操作检查
先导出资源清单,对照 Compose 挂载,清理少量悬空镜像并复查服务。
近期回滚镜像先保留。释放空间不足时分析实际卷占用,不通过扩大删除范围试错。
Docker Compose
按项目 README 的镜像、端口和目录整理,时区改为 Asia/Shanghai。此配置仅供可信局域网内管理;需要认证时使用项目支持的密码哈希配置。
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/prunemate/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/prunemate /volume1/docker/prunemate/config /volume1/docker/prunemate/logs
cd /volume1/docker/prunemate
HALO_PREPARE
cd /volume1/docker/prunemate
services:
prunemate:
image: anoniemerd/prunemate:latest
restart: unless-stopped
ports:
- "7676:8080"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- /volume1/docker/prunemate/config:/config
- /volume1/docker/prunemate/logs:/var/log
environment:
PRUNEMATE_TZ: Asia/Shanghai
PRUNEMATE_TIME_24H: "true"
在项目目录保存为 compose.yaml 后,先检查配置,再启动:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
配置与常见问题
- Docker Socket 可控制宿主机 Docker,这类管理工具仅适合可信管理员使用。
- 停止的容器和未挂载的卷也可能包含待恢复数据,不能把“未使用”直接等同于可删除。
- 页面无法打开:先用
docker compose ps检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。 - 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。
更新与备份
先备份业务应用数据,再进行资源清理;保存 PruneMate 配置与日志,业务数据不能依赖清理工具备份。
更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。