From 28eecb55ed16e35f95a9d3948bc8b5e934a81de3 Mon Sep 17 00:00:00 2001 From: jinghui <3970260761@qq.com> Date: Fri, 6 Nov 2026 16:21:59 +0800 Subject: [PATCH] docs: clean README for fnos-resmon --- README.md | 228 ++++-------------------------------------------------- 1 file changed, 14 insertions(+), 214 deletions(-) diff --git a/README.md b/README.md index d87396a..a138a2e 100644 --- a/README.md +++ b/README.md @@ -1,200 +1,21 @@ -
+# 飞牛资源管理器 (fnos-resmon) -# 🖥️ 小白系统监控器 — fnOS飞牛实时系统监控面板 - docker应用 +飞牛 NAS 资源监视器：CPU / 内存 / 磁盘 / 网络 四页签，读取宿主真实数据。 -**一键 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) +- CPU：进程 CPU 占用、线程数、PID、描述、用户、状态，可按列排序 +- 内存：RSS / USS / SWAP 三列，可按列排序 +- 磁盘：进程读写累计、挂载点、SMART 信息 +- 网络：连接数进程、TCP 连接表、侦听端口表、网卡信息 +- 内存回收：一键 drop caches 释放可回收内存 +- 进程结束：一键 kill +- 表头排序方向可视化，内部滚动自适应 +- 底部浮动导航站与开源地址入口 ---- +## 安装 -

- 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) 提出。 - ---- - -
- ---- - -## 📦 安装步骤 - -1. 下载 FPK：[fnos-resmon-v1.2.1.fpk](http://192.168.68.19:3200/attachments/61f85108-f698-4682-a273-8f9b6ebc7fac) +1. 下载 FPK：[Releases](https://gitea.88531.cn/jinghui/fnos-resmon/releases) 2. 飞牛应用中心 → 本地安装 → 选择 FPK 3. 安装完成后打开「飞牛资源管理器」，访问 `http://:7031` @@ -203,28 +24,7 @@ services: docker pull 192.168.68.19:3200/jinghui/fnos-resmon:latest ``` -## fnos-resmon（飞牛资源管理器） - -本仓库另含 fnos-resmon：CPU / 内存 / 磁盘 / 网络 四页签资源监视器，读取宿主真实数据。 - -### 功能 - -- CPU：进程 CPU 占用、线程数、PID、描述、用户、状态，可按列排序 -- 内存：RSS / USS / SWAP 三列 -- 磁盘：进程读写累计 -- 网络：连接数进程、TCP 连接表、侦听端口表 -- 内存回收：一键 drop caches -- 进程结束：一键 kill -- 表头排序方向可视化，内部滚动自适应 - -### 下载 - -- FPK：`/vol2/1000/HD2/fpk/fnos-resmon-v1.2.0.fpk` -- 镜像：`192.168.68.19:3200/jinghui/fnos-resmon:latest` - -### 链接 +## 链接 - 资享导航站：https://nav.88531.cn - 开源地址：https://gitea.88531.cn/jinghui/fnos-resmon - -