NAS 与运维

PruneMate:检查和清理 Docker 资源

  • 0 次阅读
  • 0 条评论
文章摘要

PruneMate 提供 Docker 资源清理界面和定时任务,帮助查看闲置镜像、容器、网络与卷。清理的关键是确认哪些资源仍用于恢复或回滚,不能只看可释放空间的数字。 面板展示可清理资源并安排任务,但闲置资源也可能用于回滚或临时停用项目。卷是否可删必须与应用数据对应。 适合希望整理 Docker 占用的用户。初次只处理已确认无用的镜像,自动卷清理保持关闭。

项目介绍

PruneMate 提供 Docker 资源清理界面和定时任务,帮助查看闲置镜像、容器、网络与卷。清理的关键是确认哪些资源仍用于恢复或回滚,不能只看可释放空间的数字。

面板展示可清理资源并安排任务,但闲置资源也可能用于回滚或临时停用项目。卷是否可删必须与应用数据对应。

适合希望整理 Docker 占用的用户。初次只处理已确认无用的镜像,自动卷清理保持关闭。

核心功能

功能 作用与使用方式
资源查看 区分镜像容器网络与卷
范围选择 限定清理对象
手动清理 先验证小范围操作
任务计划 按需设置低频执行
日志记录 保留删除明细

功能示意

PruneMate 功能示意图

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

PruneMate 官方界面示例
项目官方界面示例,展示上游演示数据。

项目信息

项目 说明
类型 Docker
分类 NAS 与运维
项目仓库 0x20Fearless/prunemate
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 在 NAS 创建 /volume1/docker/prunemate/config 和 logs 两个目录,把下面配置保存为项目。先只允许局域网访问管理端口。
  2. 打开 http://NAS_IP:7676,检查资源列表和清理范围。首次操作只选择确认不用的悬空镜像,保留近期可回滚版本。
  3. 清理前用 docker system df -v 查看明细,把卷名与应用配置逐一对应;暂不启用自动清理卷。
  4. 确认手动清理结果和日志后,再配置低频计划;调整计划时同步检查新安装应用使用的卷与标签。

首次使用与操作检查

先导出资源清单,对照 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。只回退镜像不一定能回退已经迁移过的数据库。

参考资料