待补充
ironsheep/RPi-Reporter-MQTT2HA-Daemon
智能家居
3/5
🧩 软硬件结合
已发布
项目简介
Linux service to collect and transfer Raspberry Pi data via MQTT to Home Assistant (for RPi Monitoring)
这是一个专为树莓派用户设计的轻量级系统监控守护进程，能够将树莓派的运行状态实时上报至Home Assistant智能家居平台。项目通过MQTT协议与Home Assistant通信，自动发送MQTT发现消息，让每台树莓派设备在Home Assistant中自动注册为独立设备，无需手动配置实体。核心功能包括监控CPU温度、GPU温度、内存使用率、磁盘使用率、CPU负载以及系统运行时间等关键指标，所有数据通过五个MQTT主题发布，其中monitor主题作为时间戳传感器承载所有监控值的模板载荷，配合官方提供的Lovelace自定义卡片即可在仪表盘上直观展示。技术栈基于Python 3开发，支持systemd服务模式后台运行，兼容树莓派Zero到4B所有型号，已在Raspbian Jessie至Bullseye系统版本上验证，MQTT认证和sd_notify系统通知功能完善。这个项目解决了多台树莓派分散管理时无法统一监控的痛点，特别适合家庭服务器集群、智能家居中枢节点、网络存储设备等场景，让用户通过Home Assistant一个界面就能掌握所有树莓派的健康状态。无需root权限即可运行，安装配置简单，只需修改配置文件中的MQTT broker地址和认证信息即可快速部署。
标签
项目特点
**自动发现与注册**：通过MQTT自动发现协议，树莓派设备在Home Assistant中自动注册为独立设备，无需手动添加实体。
**多维度系统监控**：实时监控CPU温度、GPU温度、内存使用率、磁盘使用率、CPU负载和系统运行时间等关键指标。
**MQTT主题发布**：所有数据通过五个MQTT主题发布，其中monitor主题作为时间戳传感器承载所有监控值的模板载荷。
**Lovelace卡片支持**：官方提供自定义Lovelace卡片，可在Home Assistant仪表盘上直观展示监控数据。
**轻量级守护进程**：基于Python 3开发，资源占用低，适合在树莓派上长期运行。
**开源可定制**：代码完全开源，用户可根据需求修改监控指标或扩展功能。
技术规格
| 开发语言 | Python 3 |
|---|---|
| 通信协议 | MQTT |
| 目标平台 | Raspberry Pi（全系列） |
| 监控指标 | CPU温度、GPU温度、内存使用率、磁盘使用率、CPU负载、系统运行时间 |
| MQTT主题数量 | 5个（含monitor模板主题） |
| Home Assistant集成 | 支持MQTT自动发现（MQTT Discovery） |
| 运行方式 | 系统守护进程（systemd服务） |
| 依赖库 | paho-mqtt、psutil、RPi.GPIO（可选） |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| Raspberry Pi（3B+/4B/Zero 2W等） | 1 | — | 任意型号均可 |
| MicroSD卡 | 1 | — | 用于安装操作系统 |
| 电源适配器 | 1 | — | 根据树莓派型号选择 |
| Python 3 | 1 | — | 系统预装或手动安装 |
| paho-mqtt库 | 1 | — | pip安装 |
| psutil库 | 1 | — | pip安装 |
| MQTT Broker（如Mosquitto） | 1 | — | 需在局域网内运行 |
| Home Assistant | 1 | — | 需已部署并配置MQTT集成 |
能力画像
**记忆与知识检索**：2/5 — 项目本身不涉及知识检索，但需要用户理解MQTT和Home Assistant的基本概念。
**动手与操作**：4/5 — 需要在树莓派上安装依赖、配置MQTT和Home Assistant、部署守护进程，涉及命令行操作。
**编程与算法**：2/5 — 项目已提供完整代码，用户只需配置参数，无需编写代码；但可扩展自定义监控指标。
**设计与建模**：1/5 — 项目功能固定，不涉及设计或建模工作。
**实验与调试**：3/5 — 部署过程中可能遇到MQTT连接、权限等问题，需要调试排查。
**协作与分享**：3/5 — 可通过GitHub提交Issue或PR，社区协作改进。
**学习与研究**：3/5 — 适合学习MQTT协议、Home Assistant集成、树莓派系统监控等知识。
**系统集成**：5/5 — 核心能力是将树莓派监控数据无缝集成到Home Assistant智能家居系统。
项目图库
所需技能
树莓派基础操作（SSH连接、命令行使用）
Linux系统管理（systemd服务管理、文件权限）
MQTT协议基本概念
Home Assistant基本配置（MQTT集成、Lovelace仪表盘）
Python环境管理（pip安装依赖）
网络基础知识（IP地址、端口配置）
适用场景
家庭智能家居系统中，需要实时监控多台树莓派设备的运行状态
树莓派作为服务器或媒体中心运行时，需要远程监控系统健康度
Home Assistant用户希望将树莓派作为传感器节点，自动上报系统指标
树莓派集群或分布式项目中，需要统一监控各节点资源使用情况
学习MQTT自动发现协议和Home Assistant设备集成的教学场景
树莓派长期无人值守运行时的远程运维监控