可视化Docker资源清理方案：PruneMate容器化部署实战
# 一、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 注意事项 1. **数据风险警告**：PruneMate 调用 Docker 原生 `prune` 命令，**卷（volumes）清理可能删除包含重要数据的存储**，请务必确认无关键数据后再启用卷清理。 1. **远程主机依赖**：多主机功能要求目标 Docker 主机部署 `docker-socket-proxy` 并正确配置网络与权限，否则无法连接。 1. **责任自负**：本工具不承担因误配置或误操作导致的数据丢失或系统异常，请在生产环境使用前充分测试并理解其行为。 # 二、本次实践规划 ## 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正常运行。 ``` 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版本 ``` root@jeven:~# docker -v Docker version 28.5.0, build 887030f ``` ## 3.3 检查docker compose 版本 > 检查Docker compose版本，确保2.0以上版本。 ``` root@jeven:~# docker compose version Docker Compose version v2.39.4 ``` # 四、拉取PruneMate镜像 > 下载PruneMate镜像，执行以下命令： ``` docker pull anoniemerd/prunemate:1.3.2 ```  # 五、部署PruneMate服务 ## 5.1 创建部署目录 - 创建部署目录 ``` mkdir -p /data/prunemate && cd /data/prunemate ``` ## 5.2 编辑部署文件 > 新建及编辑docker-compose.yaml文件，宿主机映射端口可自行设置，注意防止端口冲突。 ``` vim docker-compose.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容器。 ``` docker compose up -d ```  ## 5.4 查看PruneMate容器状态 > 检查PruneMate容器运行状态，确保PruneMate容器正常启动。 ``` 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服务正常运行。 ``` docker compose logs ```  # 六、访问PruneMate服务 ## 6.1 访问PruneMate首页 > 浏览器地址： `http://:7676`，访问PruneMate初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。  ## 6.2 清理资源 > 我们使用`docker system df`命令，显示 Docker 磁盘使用情况，包括镜像、容器、本地卷和构建缓存所占用的磁盘空间。 ``` 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 ``` > 勾选需要清理的选项，确认清理宿主机容器资源。    > 查看当前的容器资源状态，如下所示： ``` 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 支持灵活调度与多主机管理，兼顾自动化与手动控制，适合个人和小型团队使用。需要注意的是，在启用卷清理等高风险操作前，务必确认数据重要性，避免误删关键内容。
