服务器硬盘分析工具

面向宝塔 Linux 面板的开源只读磁盘分析插件，用来快速找出占用空间较大的目录、文件和文件类型。

功能

• 查看各挂载点容量、已用空间、剩余空间和使用率。
• 异步扫描任意合法的 Linux 绝对路径，支持取消任务。
• 展示目录递归大小、最大文件、文件类型和近期大文件。
• 根据路径、扩展名、大小和修改时间生成只读清理候选。
• 同一路径再次扫描时展示目录增长或缩减量。
• 保留最近 20 次扫描历史，结果表格支持筛选和 UTF-8 CSV 导出。
• 不跟随符号链接、不跨文件系统；扫描 / 时跳过 /proc、/sys、/dev 和 /run。

安全边界

插件只负责分析，不提供删除、移动、压缩或改写业务文件的接口。“清理建议”仅是候选列表，请人工确认后再通过其他方式处理。

扫描进程会以宝塔插件的运行权限读取目标目录。请只在自己管理或明确获授权的服务器上使用。

兼容性

• 已验证：宝塔 Linux 面板 11.8.1。
• 运行环境：Linux、Bash、宝塔面板自带 Python 3。
• 其他宝塔版本尚未逐一验证，欢迎提交 Issue 反馈。

安装

1. 从 Releases 下载 disk_analysis_pro-1.0.4.zip。
2. 不要解压，登录宝塔面板。
3. 进入“软件商店 → 第三方应用”。
4. 点击“导入插件”或“本地插件”，上传 ZIP。
5. 如果面板要求填写插件名称，输入 disk_analysis_pro。
6. 安装后搜索“服务器硬盘分析工具”，点击“设置”。

如果安装后图标未立即出现，请按 Ctrl + F5 强制刷新浏览器缓存。

项目文件

• disk_analysis_pro_main.py：宝塔插件 API。
• disk_analysis_worker.py：独立异步扫描进程。
• index.html：插件弹窗界面。
• info.json：软件商店元数据。
• install.sh：安装、更新和卸载入口。
• icon.png / icon.svg：软件商店图标。

开发与检查

python3 -m py_compile disk_analysis_pro_main.py disk_analysis_worker.py
bash -n install.sh
python3 -m json.tool info.json >/dev/null

运行数据保存在插件安装目录的 data/jobs/ 中，不应提交到版本库。

许可证与声明

本项目使用 MIT License。“宝塔”“堡塔”及相关商标归其权利人所有，本项目不是宝塔官方插件，也未获得官方背书。