PVE 服务助手
2025/11/19大约 2 分钟修仙秘籍
🖥️ PVE 服务助手
集成 Proxmox VE（PVE）节点状态查询、磁盘 SMART 信息、虚拟机列表和状态告警通知功能。通过 PVE REST API 采集数据，作为 nasInfo provider 接入系统统一面板。
⚙️ 功能特点
- 采集 PVE 节点 CPU、内存、温度等状态
- 查询磁盘 SMART 健康信息
- 获取虚拟机/容器列表及运行状态
- 系统状态阈值告警通知
- PVE 任务失败时推送通知（备份失败、迁移失败等）
- 支持多实例，可配置多台 PVE 节点
🚀 配置指南
连接配置
| 参数 | 必填 | 说明 |
|---|---|---|
| PVE 地址 | 是 | 包含协议和端口，如 https://192.168.50.100:8006 |
| 节点名 | 否 | PVE 节点名称，默认 pve，集群多节点时填写目标节点名 |
| API Token ID | 是 | 格式 <用户>@<realm>!<tokenid>，如 root@pam!media |
| API Token Secret | 是 | 创建 Token 时给出的密钥 UUID |
| 跳过 TLS 证书校验 | 否 | PVE 默认自签名证书，建议开启 |
功能开关
| 参数 | 必填 | 说明 |
|---|---|---|
| 启用其他服务最新状态查询 | 否 | 允许其他服务调用 PVE 状态接口 |
| 启用系统消息通知 | 否 | PVE 任务失败时推送通知 |
| 系统消息检测定时任务 | 否 | 检测频率，推荐 */5 * * * * |
| 启用系统状态提醒通知 | 否 | 超过阈值时发送告警 |
| 系统状态检测定时任务 | 否 | 检测频率，推荐 */5 * * * * |
| 系统状态提醒发送频率(分钟) | 否 | 告警发送间隔，默认每次都发 |
| CPU 提醒百分比阈值 | 否 | 默认 80% |
| 内存提醒百分比阈值 | 否 | 默认 80% |
| 温度提醒阈值(℃) | 否 | CPU 封装温度，默认 60℃ |
🔧 工具栏操作
- 立即执行一次：手动触发一次状态采集
- 手动发送状态通知：立即发送一次状态告警
- 手动发送系统消息：立即检查并发送系统消息
📖 使用说明
创建 API Token
- 登录 PVE Web 管理界面；
- 进入「数据中心 → 权限 → API 令牌」；
- 创建新令牌，记录 Token ID 和 Secret；
- 确保令牌有足够权限读取节点状态和任务信息。
配置步骤
- 填写 PVE 地址和 API Token 信息；
- 如使用自签名证书（默认），开启「跳过 TLS 证书校验」；
- 根据需要开启状态告警和/或系统消息通知；
- 点击「立即执行一次」验证连接。
⚠️ 注意事项
- API Token 需要有读取节点状态的权限；
- PVE 默认使用自签名证书，不开启跳过校验会连接失败；
- 状态检测频率不宜过高，推荐 5 分钟以上。