diff --git a/README.md b/README.md new file mode 100644 index 0000000..3157307 --- /dev/null +++ b/README.md @@ -0,0 +1,195 @@ +
+ +# 🖥️ fnmon — fnOS 实时系统监控面板 + +**一键 Docker 部署 | 6 大监控维度 | 数据可导出** + +[![Docker Hub](https://img.shields.io/badge/Docker-Hub-2496ED?style=flat&logo=docker)](https://hub.docker.com/r/jinghui1984/fnmon) +[![GitHub stars](https://img.shields.io/github/stars/personal82555/fnmon?style=social)](https://github.com/personal82555/fnmon) +[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE) +[![fnOS](https://img.shields.io/badge/fnOS-%E9%A3%9E%E7%89%9B-orange)](https://www.fnnas.com) + +--- + +

+ fnmon 总览 +

+ +**fnmon** 是一款专为飞牛 fnOS 打造的实时系统监控面板。一个 Docker 命令即可拥有媲美专业 NAS 监控的 Web 界面，涵盖 **CPU、内存、网络、磁盘、进程排行、应用用量** 六大维度，所有历史数据支持一键导出。 + +
+ +--- + +## ✨ 核心特性 + +| 特性 | 说明 | +|------|------| +| 🚀 **一键部署** | 一条 `docker run` 命令启动，无需安装驱动 | +| ⚡ **实时推送** | SSE 技术，2 秒刷新一次，延迟极低 | +| 📊 **维度全面** | 6 大面板覆盖系统全部关键指标 | +| 💾 **数据导出** | 一键导出所有历史数据到 NAS 目录，JSON 格式 | +| 📱 **移动适配** | 深色主题，侧边栏导航，屏幕利用率高 | +| 🐳 **零侵入** | Docker 容器运行，不修改系统文件 | + +--- + +## 📸 功能截图 + +### ⚡ CPU 监控 +实时显示 CPU 型号、每个核心的当前频率、Governor/EPP 运行模式、核心温度（支持 SATA/NVMe 硬盘温度）、Turbo Boost 状态、60 秒频率历史曲线图。还包括 CPU 评测跑分（PassMark/Cinebench/Geekbench）和同级 CPU 横向对比。 + +

+ CPU 面板 +

+ +### 🧠 内存监控 +总容量 / 已用 / 可用 / 缓存 / SWAP 全面展示，进度条可视化，数据实时更新。 + +

+ 内存面板 +

+ +### 🌐 网络流量 +实时上传/下载网速、当月/当日累计流量、Docker 容器流量排行（TOP 15）、60 秒流量趋势图。 + +

+ 网络面板 +

+ +### 💾 磁盘健康 +物理硬盘列表（型号、容量、接口类型）、SMART 健康状态、硬盘温度、NVMe 寿命百分比、通电时间、总写入量。磁盘分区挂载点使用率 + 60 秒 I/O 趋势图。 + +

+ 磁盘面板 +

+ +### 📱 应用用量排行 +综合 CPU + 内存 + 网络 三维度加权评分，可按 **日/周/月/年/总计** 切换时间维度，快速定位资源消耗大户。 + +

+ 应用用量排行 +

+ +### 🔝 进程 CPU 排名 +实时 TOP 20 进程，含 PID、用户、CPU%、内存%、启动时间。CPU% 用颜色标识（🔴>50% / 🟠>20% / 🟡>5%）。 + +--- + +## 🚀 快速开始 + +### 方式一：Docker 运行（推荐） + +```bash +docker run -d --name fnmon -p 5000:5000 --privileged \ + -v /proc:/proc:ro -v /sys:/sys:ro \ + -v /vol2/fnmon-exports:/var/exports \ + jinghui1984/fnmon +``` + +启动后浏览器访问 `http://你的NASIP:5000` 即可。 + +> **📌 导出目录说明：** `-v /vol2/fnmon-exports:/var/exports` 用于保存导出的历史数据，如不需要可省略。 + +### 方式二：Docker Compose + +```yaml +version: '3' +services: + fnmon: + image: jinghui1984/fnmon + container_name: fnmon + restart: always + ports: + - "5000:5000" + privileged: true + volumes: + - /proc:/proc:ro + - /sys:/sys:ro + - /vol2/fnmon-exports:/var/exports + environment: + - TZ=Asia/Shanghai +``` + +--- + +## 🔧 功能详解 + +### 数据导出 + +点击侧边栏底部的 **⬇️ 导出** 按钮，一键将所有历史数据保存为 JSON 文件到挂载的 NAS 目录。文件名格式：`fnmon-export-YYYY-MM-DD-HHMMSS.json`。 + +导出的数据包含： + +| 内容 | 说明 | +|------|------| +| CPU 实时数据 | 频率、温度、Governor、EPP | +| 内存快照 | 已用、缓存、SWAP | +| 网络历史 | 60 秒流量队列 | +| 磁盘 I/O | 设备读写速率 | +| 应用用量 | SQLite 全量数据（日/周/月/年 聚合） | +| Docker 流量 | 容器网络存档 | + +通过 ⚙️ **设置** 按钮可自由配置导出路径。 + +### 历史数据追踪 + +- **网络流量**：累计统计总/日/月 流量，Docker 容器排行 +- **应用用量**：60 秒采集一次进程 + Docker 资源快照，自动聚合到日/周/月/年维度 +- **SSE 实时推送**：2 秒间隔推送所有数据，前端自动渲染 + +--- + +## 🛠️ 技术栈 + +| 组件 | 技术选型 | +|------|---------| +| 后端框架 | Flask (Python) | +| 前端 | 纯 HTML/CSS/JS（无额外依赖） | +| 实时通信 | Server-Sent Events (SSE) | +| 数据采集 | psutil、smartctl、/proc 文件系统 | +| 数据存储 | SQLite（应用用量 + 流量审计） | +| 容器化 | Docker（基于 python:3.9-slim） | +| 镜像大小 | ~342MB | + +--- + +## 📋 功能清单 + +- [x] CPU 频率 / 核心温度 / Governor / EPP +- [x] 内存 / SWAP 实时 & 趋势 +- [x] 网络流量实时 & 累计（日 / 月 / 总） +- [x] Docker 容器流量排行 +- [x] 磁盘分区使用率 & I/O 趋势 +- [x] 物理硬盘健康（SMART / NVMe 寿命） +- [x] 进程 CPU 占用排行（TOP 20） +- [x] 应用用量排行（日/周/月/年） +- [x] CPU 评测跑分 & 同级对比 +- [x] 一键数据导出 +- [ ] 暗色 / 亮色主题切换 +- [ ] 微信 / 邮件告警 +- [ ] 多语言支持 + +--- + +## 📦 下载 + +| 资源 | 地址 | +|------|------| +| Docker Hub | `jinghui1984/fnmon` | +| GitHub | 本仓库 | +| 论坛讨论 | [飞牛论坛](https://club.fnnas.com) | + +--- + +## 🤝 贡献 + +欢迎 Issue 和 PR！如果你有好的想法或发现了 Bug，请到 [Issues](https://github.com/personal82555/fnmon/issues) 提出。 + +--- + +
+ +**如果这个项目对你有帮助，欢迎 ⭐Star 支持！** + +