PVE-Manager-Status

为你的 ProxmoxVE 节点概要页面添加扩展的硬件监控信息

无论是小型 HomeLab 还是多节点的大型集群, 借助 PVE-Manager-Status 让你对当前服务器硬件状态了如指掌!

PVE-Manager-Status 是一款强大的开源脚本工具, 通过实时基于动态色彩的关键指标显示, 帮助你直观的了解服务器各项硬件的负载和温度, 从而轻松掌握设备的实时运行状态以确保其稳定高效.

免责声明

在任何正式或关键的生产环境中, 未经完整测试与评估, 严禁直接部署和运行本工具. 在使用本工具之前, 务必对代码进行详尽的审阅, 充分理解其运行机制, 使用该工具后的风险由您自行承担.

包含的功能

• 为ProxmoxVE Web 管理界面的节点概要中添加各项硬件的实时监控信息.
• 根据各项硬件的温度和负载, 使用红黄绿色从高到低来显示各项参数的数值.
• 支持识别多块 NMVe 硬盘, 并根据寿命和压力负载显示动态色彩指标.
• 完善 zh-CN 本地化, 修复中文环境下缺失的翻译部分.

如何使用

要使用本项目, 请通过 SSH 以 root 身份连接你的 Proxmox VE 节点, 并执行以下操作:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/MiKing233/PVE-Manager-Status/master/pve-manager-status.sh)"

执行完毕后, 使用 Ctrl + F5 刷新浏览器 Proxmox VE Web 管理页面缓存.

若此时可以看到 PVE-Manager-Status 带来的扩展的硬件监控信息, 但无法看到风扇转速信息, 你还需要继续执行以下步骤来安裝 IT87 系列传感器驱动包:

wget -O /root/it87-dkms_1.0.63-1_all.deb https://raw.githubusercontent.com/MiKing233/PVE-Manager-Status/master/it87-dkms_1.0.63-1_all.deb && apt install /root/it87-dkms_1.0.63-1_all.deb && rm -f /root/it87-dkms_1.0.63-1_all.deb

执行完毕后, 重启系统并再次检查风扇转速信息.

已知问题

• SATA 硬盘监控的代码实现部分, 未经过任何形式的测试, 也许完全不起作用, 我目前没有能够使用 SATA 硬盘的 x86 设备无法对这部分进行测试.
• nvme 硬盘监控部分对于 I/O 实时读写速度和延迟的实现代码使用目前常见的 iostat -d -x -k 1 1 但这将导致长时间运行后 iostat 进程休眠或被杀死, 你将会看到这部分监控参数"冻结", 在重启前将永远不再刷新, 目前尝试过使用其它方式实现这个功能避免冻结, 但都未能达到预期的效果, 有些实现方式复杂超出预期短期内无法解决, 另外一些能生效的方法则不够优雅, 会导致Web页面自动刷新间隔变得非常长.

未来计划

• 修复长时间运行 nvme 硬盘监控部分 I/O读写延迟冻结的问题.

相容性

• 适用于基于 Debian 12 "bookworm" 的 Proxmox VE 8.x 和基于 Debian 13 "trixie" 的 Proxmox VE 9.0-1.
• 理论上支持 Proxmox VE 7.x 等旧版环境但未经过实际测试. 您需要在拥有root权限的节点上运行该工具执行修改.
• 在将脚本应用到实际环境之前, 最好先在测试环境进行测试, 若发生意外请通过下面的命令重新安装 pve-manager 来复原被修改的文件.

apt install --reinstall pve-manager

贡献

欢迎您的贡献! 如果您有任何改进或调整, 请 Fork 代码库并提交拉取请求.

联系与反馈

如果您遇到任何问题或有任何建议, 请在 GitHub 代码库中提交问题.

致谢

感谢以下来源和社区贡献, 本项目的诞生离不开源自这些来源和贡献:

• https://github.com/a1wong/it87
• https://github.com/shidahuilang/pve
• https://github.com/xiangfeidexiaohuo/pve-diy
• https://bbs.x86pi.com/thread?topicId=20
• https://community-scripts.github.io/ProxmoxVE
• https://github.com/community-scripts/ProxmoxVE
• https://github.com/proxmox/pve-manager
• https://github.com/Debian

贡献者

许可证

本项目为开源项目, 遵循 MIT License.

这些代码按"原样"提供, 不提供任何担保, 也不授予任何权利. 您有责任安全地使用本工具, 并遵守软件许可协议的条款.

请我喝杯咖啡

捐赠是本项目唯一的收入来源, 如果您愿意支持这个项目, 这将帮助该项目走得更远! 感谢您的支持!

• https://donate.mknetwork.net

如果你喜欢这个项目, 请不要吝啬您的 Star 🌟

Enjoy a better Proxmox VE experience!