Skip to content

EndlessPixel/SystemStatus

Repository files navigation

SystemStatus

Docker Pulls Stars License Python FastAPI Platform

🐳 Docker 一行命令启动 · 轻量级系统硬件监控面板
实时监控 CPU / 内存 / 硬盘 / 网卡 / 显卡(Intel 核显 + NVIDIA 独显)


🤔 它是什么?适合谁?

SystemStatus 是一个基于 FastAPI + ECharts 的轻量级系统监控工具,专为以下场景设计:

适合你,如果你... ❌ 不适合你,如果你...
有一台远程 Windows / Linux 服务器,不想装 RDP / VNC 需要 Kubernetes / 集群级监控(请用 Prometheus)
用 Docker / NAS(群晖 / Unraid / TrueNAS),想一键跑监控 追求极致性能、单二进制部署(请用 btop / htop)
想在手机浏览器随时查看服务器状态 就在本机用,且有任务管理器 / Activity Monitor
需要 Intel 核显使用率监控(独家支持)
希望界面和文档完全中文,开箱即用

💡 一句话定位: 一个为「非运维人员」设计的、Docker 一行启动的系统监控面板。


🐳 Docker 一键部署(推荐)

快速启动

docker pull systemmini/systemstatus

docker run -d \
  --name systemstatus \
  -p 8001:8001 \
  --privileged \
  systemmini/systemstatus

浏览器访问 http://localhost:8001 即可。

Windows / macOS(Docker Desktop)

无需额外参数,直接运行即可,适合:

  • 🖥️ Windows Server 远程监控
  • 💻 本地开发调试
  • 🏠 NAS / 家庭服务器

💡 相比 netdata / glances,SystemStatus 镜像更小、启动更快、UI 更简洁。


🚀 本地开发启动

环境准备

确保已安装 Python 3.8+,然后安装依赖:

pip install -r requirements.txt

启动服务

python main.py

服务启动在 **http://0.0.0.0:8001**,浏览器访问即可。


✨ 功能特性

🖥️ 硬件信息监控

  • CPU:型号、核心数、实时占用率(单核心 + 整体折线图)
  • 内存:容量、型号、实时占用率
  • 硬盘:分区列表、已用/总容量(GB 显示)、占用百分比
  • 网卡:名称与 IPv4 地址
  • 显卡:型号检测(兼容 Intel 核显 + NVIDIA 独显
    • Intel 核显使用率检测(wmic)
    • NVIDIA 显卡使用率检测(NVML)

⚡ 性能优化

  • 本地缓存文件 tmp.json,页面打开秒加载
  • 浏览器 localStorage 缓存,断网也能看历史数据
  • 每秒采集实时数据,折线图动态展示趋势
  • 无 NVIDIA 显卡时自动禁用 NVML,避免错误刷屏
  • 使用 wmic 替代 wmi COM 接口,彻底解决 Win32 IUnknown 异常
  • 硬盘占用率增量更新,避免每次完全重绘
  • 重启服务器后自动从缓存恢复历史数据
  • 静态资源与后端服务合并,无需额外 http.server

🎨 主题与外观

  • Apple 风格极简设计,通透、圆角、细腻阴影
  • 三种主题:浅色模式 / 深色模式 / 高对比度模式
  • 主题通过下拉菜单快速切换
  • 折叠面板时自动消除空白空间

🌍 多语言支持 (i18n)

  • 内置:简体中文、English、日本語、Deutsch、Français、Русский
  • 自动检测浏览器语言偏好
  • 所有 UI 元素(图表、下拉菜单、网络标签)完全翻译
  • 语言文件独立管理,方便扩展

📱 UI/UX

  • 响应式布局,手机 / 平板 / 桌面端均友好
  • 硬盘占用率默认 2 列布局,窄屏自动切换 1 列
  • 所有图表面板支持折叠/展开,一键全部折叠/展开
  • 平滑的折叠/展开动画
  • 数字动画,数值变化更流畅

🔌 跨平台兼容

  • Windows:通过 wmic 命令获取硬件详情
  • Linux:通过 /proc/cpuinfo / dmidecode 兼容

🌟 独特之处

SystemStatus 是极少数同时做到以下三点的开源监控工具:

能力 SystemStatus netdata glances btop
Intel 核显监控 ⚠️
Docker 一键部署
Apple 风格 Web UI
  • 🏆 唯一原生支持 Intel 核显使用率 的轻量 Web 监控工具
  • 🛡️ 针对 Windows WMI 稳定性做了大量工程优化
  • 🪶 极低依赖,单容器即可运行

📡 API 接口

接口地址 请求方式 功能描述
/api/hardware-info GET 获取硬件基础信息(CPU / 内存 / 显卡 / 网卡)
/api/real-time-data GET 获取实时监控数据(折线图 + 核心占用)
/api/disk-usage GET 获取硬盘分区占用信息
/api/cache GET 获取 tmp.json 缓存数据
/api/version GET 获取当前 Git 提交 SHA 版本信息

🤝 贡献指南

欢迎提交 Issue 反馈 Bug 或需求,也可以直接提交 Pull Request 改进代码!

  1. Fork 本仓库
  2. 创建特性分支:git checkout -b feat/xxx
  3. 提交 Commit:git commit -m "feat: 新增 xxx"
  4. 推送分支并提交 Pull Request

📄 许可证

本项目基于 Apache License Version 2.0 开源。


💬 关于

⭐ Star 是对我们最大的支持!

About

轻量级系统硬件监控工具 | 实时监控CPU/内存/硬盘/显卡(Intel核显+NVIDIA独显)| FastAPI + ECharts | 缓存秒开 | 跨平台

Topics

Resources

License

Stars

Watchers

Forks

Contributors