# HardwareMonitoring

**Repository Path**: c4plan/HardwareMonitoring

## Basic Information

- **Project Name**: HardwareMonitoring
- **Description**: 树莓派硬件监控服务，获取相关的运行的服务相关信息与硬件cpu温度，cpu使用率，内存使用率的相关信息
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-28
- **Last Updated**: 2026-06-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, oshi

## README

# HardwareMonitoring

#### 介绍
树莓派硬件监控服务（Java版） —— 基于 Spring Boot 的轻量级硬件监控解决方案，专为 Raspberry Pi 优化设计。实时采集 CPU 温度、使用率、内存状态、磁盘空间及关键服务运行状态，提供 Web 仪表盘与实时数据推送，助力树莓派设备稳定运行。适用于家庭服务器、IoT 网关、边缘计算节点等资源受限场景。

#### 核心能力

1. 精准硬件监控：CPU 温度（直读 /sys/class/thermal）、分核使用率、内存/磁盘实时状态
2. 服务健康检测：关键 systemd 服务存活状态监控
3. 实时数据流：WebSocket 推送，仪表盘动态刷新无延迟
4. 智能阈值告警：温度/资源超限自动触发（邮件/日志通知）
5. 响应式 Web 仪表盘：手机/PC 无缝访问，无需额外前端框架
6. 低资源占用：专为树莓派 ARM 架构优化


#### 软件架构
| 层级 | 组件 | 作用 | 树莓派适配优势 |
|------|------|------|----------------|
| 核心框架 | Spring Boot 2.7.18 | 微服务骨架 + 内嵌 Tomcat | 无需外部 Web 服务器，启动快 |
| 硬件采集 | OSHI 6.4.10 | 纯 Java 硬件信息库 | 直接解析 `/sys` 路径，无需安装 lm-sensors 等系统工具 |
| 实时通信 | Spring WebSocket | 服务端主动推送指标 | 比 HTTP 轮询降低 60%+ 网络开销 |
| 开发效率 | Lombok | 消除样板代码（@Data/@Slf4j） | 编译期生成，零运行时开销 |
| 构建部署 | Maven + Spring Boot Plugin | 一键打包可执行 JAR | `java -jar hwmon.jar` 直接运行 |