一个轻量级的 系统硬件监控工具,基于 FastAPI + ECharts 实现,支持实时查看 CPU、内存、硬盘、网卡、显卡(含 Intel 核显)状态,自带缓存机制实现「现开现用」。
✅ 硬件信息监控
- CPU 型号、核心数、实时占用率(单核心+整体)
- 内存容量、型号、实时占用率
- 硬盘分区、已用/总容量、占用百分比
- 网卡名称与 IPv4 地址
- 显卡型号检测(兼容 Intel 核显 + NVIDIA 独显)
✅ 性能优化
- 本地缓存文件
tmp.json,页面打开秒加载 - 浏览器 localStorage 缓存,断网也能看历史数据
- 每秒采集实时数据,折线图动态展示趋势
- 无 NVIDIA 显卡时永久禁用 NVML,避免错误刷屏
- 移除频繁的 WMI COM 接口调用,减少 Win32 IUnknown 异常
- 硬盘占用率增量更新,避免每次完全重绘
✅ UI/UX 改进
- Apple 风格极简设计,通透、圆角、细腻阴影
- 硬盘占用率默认 2 列布局,窄屏自动切换 1 列
- 所有图表面板支持折叠/展开功能
- 一键折叠/展开所有图表
- 平滑的折叠/展开动画效果
- 数字动画,更流畅的数值变化体验
- 单位显示稳定,不会时有时无
✅ 跨平台兼容
- Windows 系统:通过
wmic命令获取硬件详情 - Linux 系统:通过
/proc/cpuinfo/dmidecode兼容
SystemStatus/
├── ips.json # 存储 IP 地址的 JSON 文件
├── main.py # 后端 FastAPI 服务
├── index.html # 前端监控页面
├── script.js # 前端交互逻辑
├── style.css # 前端样式文件
├── echarts.js # ECharts 图表库
├── LICENSE # Apache License Version 2.0 开源许可证
├── README.md # 项目说明文档
└── tmp.json # 自动生成的缓存文件
确保已安装 Python 3.8+,然后安装依赖:
pip install fastapi uvicorn psutil wmi py3nvml
py3nvml:可选,仅用于检测 NVIDIA 独显wmi:Windows 平台必装,用于读取硬件信息
python main.py
服务会启动在 http://0.0.0.0:8000
直接用浏览器打开 index.html,或通过 VS Code Live Server 启动(避免跨域问题)。
| 接口地址 | 请求方式 | 功能描述 |
|---|---|---|
/api/hardware-info |
GET | 获取硬件基础信息(CPU/内存/显卡/网卡) |
/api/real-time-data |
GET | 获取实时监控数据(折线图 + 核心占用) |
/api/disk-usage |
GET | 获取硬盘分区占用信息 |
/api/cache |
GET | 获取 tmp.json 缓存数据 |
- Windows:确保已安装显卡/内存驱动,以管理员身份运行命令行
- Linux:安装
dmidecode工具:sudo apt install dmidecode
- 后端已配置 CORS 允许所有来源,推荐用 Live Server 打开前端页面
- 生产环境请修改
main.py中的allow_origins为具体域名
- 检查后端服务是否正常运行
- 按 F12 打开控制台,查看是否有接口请求失败
- 已优化,无 NVIDIA 显卡时会永久禁用 NVML,不再尝试恢复
- 不会再出现持续的 NVMLError_LibraryNotFound 错误
本项目基于 ** Apache License Version 2.0** 开源
欢迎提交 Issue 反馈 Bug 或需求,也可以直接提交 Pull Request 改进代码~