可视化Docker资源清理方案：PruneMate容器化部署实战

一、PruneMate介绍
- [1.1 PruneMate简介](#1.1 PruneMate简介)
- [1.2 PruneMate主要特点](#1.2 PruneMate主要特点)
- [1.3 注意事项](#1.3 注意事项)
二、本次实践规划
- [2.1 本地环境规划](#2.1 本地环境规划)
- [2.2 本次实践介绍](#2.2 本次实践介绍)
三、本地环境检查
- [3.1 检查Docker服务状态](#3.1 检查Docker服务状态)
- [3.2 检查Docker版本](#3.2 检查Docker版本)
- [3.3 检查docker compose 版本](#3.3 检查docker compose 版本)
四、拉取PruneMate镜像
五、部署PruneMate服务
- [5.1 创建部署目录](#5.1 创建部署目录)
- [5.2 编辑部署文件](#5.2 编辑部署文件)
- [5.3 创建PruneMate容器](#5.3 创建PruneMate容器)
- [5.4 查看PruneMate容器状态](#5.4 查看PruneMate容器状态)
- [5.5 检查PruneMate容器日志](#5.5 检查PruneMate容器日志)
六、访问PruneMate服务
- [6.1 访问PruneMate首页](#6.1 访问PruneMate首页)
- [6.2 清理资源](#6.2 清理资源)
七、总结

一、PruneMate介绍

1.1 PruneMate简介

PruneMate** 是一个基于 Python（Flask）、Docker SDK、APScheduler 和 Gunicorn 构建的轻量级 Web 应用，旨在通过友好的网页界面自动化清理 Docker 主机上未使用的资源（如容器、镜像、网络、卷和构建缓存），帮助用户保持 Docker 环境整洁高效。

1.2 PruneMate主要特点

灵活调度：支持每日、每周或每月自动清理任务，并可随时切换为仅手动运行模式。
调度开关：一键启用或禁用自动计划，确保在需要时完全控制清理行为。
清理预览：执行手动清理前，清晰展示将被删除的资源列表，避免误操作。
时区与时间格式自定义：支持配置本地时区及 12/24 小时制时间显示，提升用户体验。
多主机管理 ：通过集成 docker-socket-proxy，可从单一界面管理多个远程 Docker 主机。
选择性清理：按需勾选清理对象------容器、镜像、网络、卷或构建缓存，精细控制清理范围。
构建缓存清理：专门支持清理 Docker Builder 缓存，常可释放数十 GB 存储空间。
历史统计追踪：记录每次清理操作释放的空间量及删除的资源数量，便于长期监控。
主页仪表盘集成：登录后可在主页直观查看清理历史与资源回收趋势。
现代响应式 UI：深色主题设计，支持移动端，动画流畅，操作直观。
安全认证机制：可选密码登录（支持哈希存储）或 Basic Auth，保护敏感操作入口。
多架构原生支持：提供 amd64 与 arm64 镜像，兼容 Intel/AMD、Raspberry Pi 及 Apple Silicon 设备。
安全可控执行：所有自动或手动操作均附带详细日志，确保过程透明可追溯。
详细清理报告：每次运行后生成结构化报告，明确列出已删除项及释放的磁盘空间。

1.3 注意事项

数据风险警告 ：PruneMate 调用 Docker 原生 prune 命令，卷（volumes）清理可能删除包含重要数据的存储，请务必确认无关键数据后再启用卷清理。
远程主机依赖 ：多主机功能要求目标 Docker 主机部署 docker-socket-proxy 并正确配置网络与权限，否则无法连接。
责任自负：本工具不承担因误配置或误操作导致的数据丢失或系统异常，请在生产环境使用前充分测试并理解其行为。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

hostname	IP地址	操作系统版本	Docker版本	部署项目	备注
jeven	192.168.3.88	Ubuntu 24.04.2 LTS	28.5.0	PruneMate	------

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；

2.在Docker环境下部署PruneMate容器资源清理工具。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

bash 复制代码

root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Tue 2026-01-06 17:39:44 CST; 6h ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 1220391 (dockerd)
      Tasks: 50
     Memory: 111.9M (peak: 706.6M swap: 5.2M swap peak: 5.2M)
        CPU: 4min 33.194s
     CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

bash 复制代码

root@jeven:~# docker -v
Docker version 28.5.0, build 887030f

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

bash 复制代码

root@jeven:~# docker compose version
Docker Compose version v2.39.4

四、拉取PruneMate镜像

下载PruneMate镜像，执行以下命令：

bash 复制代码

docker pull anoniemerd/prunemate:1.3.2

五、部署PruneMate服务

5.1 创建部署目录

bash 复制代码

mkdir -p /data/prunemate  && cd  /data/prunemate

5.2 编辑部署文件

新建及编辑docker-compose.yaml文件，宿主机映射端口可自行设置，注意防止端口冲突。

bash 复制代码

vim docker-compose.yaml

yaml 复制代码

services:
  prunemate:
    image: anoniemerd/prunemate:1.3.2  # Supports amd64 and arm64
    container_name: prunemate
    ports:
      - "7676:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./logs:/var/log
      - ./config:/config
    environment:
      - PRUNEMATE_TZ=Asia/Shanghai # Change this to your desired timezone
      - PRUNEMATE_TIME_24H=true #false for 12-Hour format (AM/PM)
      # Optional: Enable authentication (generate hash with: docker run --rm anoniemerd/prunemate python prunemate.py --gen-hash "password")
      # - PRUNEMATE_AUTH_USER=admin
      # - PRUNEMATE_AUTH_PASSWORD_HASH=your_base64_encoded_hash_here
    restart: unless-stopped

5.3 创建PruneMate容器

执行以下命令，创建PruneMate容器。

bash 复制代码

docker compose up -d

5.4 查看PruneMate容器状态

检查PruneMate容器运行状态，确保PruneMate容器正常启动。

bash 复制代码

root@jeven:/data/prunemate#  docker compose ps
NAME        IMAGE                        COMMAND                 SERVICE     CREATED          STATUS          PORTS
prunemate   anoniemerd/prunemate:1.3.2   "python prunemate.py"   prunemate   29 seconds ago   Up 28 seconds   0.0.0.0:7676->8080/tcp, [::]:7676->8080/tcp

5.5 检查PruneMate容器日志

检查容器运行日志，确保PruneMate服务正常运行。

bash 复制代码

docker compose logs

六、访问PruneMate服务

6.1 访问PruneMate首页

浏览器地址： http://<个人的服务器IP>:7676，访问PruneMate初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

6.2 清理资源

我们使用docker system df 命令，显示 Docker 磁盘使用情况，包括镜像、容器、本地卷和构建缓存所占用的磁盘空间。

bash 复制代码

root@jeven:/data/prunemate# docker system df
TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          93        2         66.4GB    66.04GB (99%)
Containers      2         2         932kB     0B (0%)
Local Volumes   9         0         33.79MB   33.79MB (100%)
Build Cache     69        0         1.046GB   1.046GB

勾选需要清理的选项，确认清理宿主机容器资源。

查看当前的容器资源状态，如下所示：

bash 复制代码

root@jeven:/data/prunemate# docker system df
TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          2         2         364.1MB   0B (0%)
Containers      2         2         932kB     0B (0%)
Local Volumes   0         0         0B        0B
Build Cache     0         0         0B        0B

七、总结

本次实践成功通过 Docker 部署了 PruneMate 容器资源清理工具，验证了其轻量、易用且功能完整的特性。通过 Web 界面可直观预览并安全清理未使用的镜像、容器、网络、卷及构建缓存，有效释放磁盘空间。PruneMate 支持灵活调度与多主机管理，兼顾自动化与手动控制，适合个人和小型团队使用。需要注意的是，在启用卷清理等高风险操作前，务必确认数据重要性，避免误删关键内容。