ironsheep/RPi-Reporter-MQTT2HA-Daemon

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地址和认证信息即可快速部署。