docs: detailed README

This commit is contained in:
jinghui committed 2026-11-06 16:27:02 +08:00
1 parent 5d46667aef
commit 9e2475dfe0
1 file changed
+98 -17
+98 -17
View File
@@ -1,32 +1,113 @@
# 飞牛资源管理器 (fnos-resmon) # 飞牛资源管理器 (fnos-resmon)
飞牛 NAS 资源监视器:CPU / 内存 / 磁盘 / 网络 四页签,读取宿主真实数据。 > 飞牛 NAS 专属的轻量级系统资源监控面板 —— 一个 Docker 命令即可拥有媲美专业 NAS 监控的 Web 界面。
![截图](docs/screenshot.png) ![截图](docs/screenshot.png)
## 功能 [![Gitea](https://img.shields.io/badge/Gitea-fnos--resmon-blue)](https://gitea.88531.cn/jinghui/fnos-resmon)
[![镜像](https://img.shields.io/badge/Docker-TCR-green)](https://gitea.88531.cn/jinghui/fnos-resmon)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
- CPU:进程 CPU 占用、线程数、PID、描述、用户、状态,可按列排序;CPU 型号/频率/核心温度 ---
- 内存:RSS / USS / SWAP 三列,内存槽位、Swap 使用率
- 磁盘:进程读写累计、挂载点、SMART 健康、温度、通电时间
- 网络:连接数进程、TCP 连接表、侦听端口表、网卡信息
- 内存回收:一键 drop caches 释放可回收内存
- 进程结束:一键 kill
- 表头排序方向可视化,内部滚动自适应
- 底部浮动导航站与开源地址入口
## 安装 ## ✨ 为什么选择 fnos-resmon?
1. 下载 FPK:[Releases](https://gitea.88531.cn/jinghui/fnos-resmon/releases) - 🚀 **一键部署**:一条 `docker run` 启动,无需额外驱动
2. 飞牛应用中心 → 本地安装 → 选择 FPK - ⚡ **实时刷新**:3 秒自动更新,数据实时
3. 安装完成后打开「飞牛资源管理器」,访问 `http://<NAS IP>:7031` - 📊 **维度全面**:CPU / 内存 / 磁盘 / 网络 四大面板,进程级明细
- 🔍 **进程级洞察**:每个进程 CPU、内存、IO、连接数一目了然
- 🧹 **内存回收**:一键 drop caches 释放可回收内存
- 🔪 **进程管理**:一键结束异常进程
- 📱 **移动适配**:响应式布局,手机也能看
- 🐳 **零侵入**:Docker 容器运行,不修改系统文件
---
## 📸 功能截图
![主界面](docs/screenshot.png)
---
## 📋 功能清单
### CPU 监控
- CPU 型号、架构、物理/逻辑核数
- 实时 CPU 占用率、负载(1/5/15 分钟)
- 每核心频率与占用率可视化
- L1/L2/L3 缓存信息
- 进程 CPU 占用排行(TOP N)
### 内存监控
- 内存占用率、已用/总共/可用
- SWAP 使用情况
- 物理内存槽位详情(容量、类型、频率、厂商)
- 进程 RSS / USS / SWAP 明细
- 一键回收可回收内存(drop caches)
### 磁盘监控
- 挂载点使用率、读写累计
- 物理硬盘 SMART 健康状态
- 硬盘温度、通电时间、坏道重映射
- 阵列拓扑展示
### 网络监控
- 实时上传/下载速率、累计收发量
- 连接数统计
- TCP 连接明细表(进程、本地/远程地址、状态)
- 侦听端口表
- 网卡信息(IP、MAC、速率、双工、MTU、驱动)
---
## 🚀 快速开始
### 方式一:Docker 运行(推荐)
或直接拉取镜像:
```bash ```bash
docker pull jpccr.ccs.tencentyun.com/jinghui/fnos-resmon:latest docker run -d --name fnos-resmon -p 7031:7031 --privileged \
-v /proc:/host/proc:rw -v /sys:/host/sys:ro \
jpccr.ccs.tencentyun.com/jinghui/fnos-resmon:latest
``` ```
## 链接 启动后浏览器访问 `http://你的NASIP:7031` 即可。
### 方式二:飞牛应用中心安装 FPK
1. 下载 [Releases](https://gitea.88531.cn/jinghui/fnos-resmon/releases) 中的 FPK
2. 飞牛应用中心 → 本地安装 → 选择 FPK
3. 安装完成后打开「飞牛资源管理器」
---
## 🛠️ 技术栈
| 组件 | 技术选型 |
|------|---------|
| 后端框架 | Flask (Python) |
| 前端 | 纯 HTML/CSS/JS(无额外依赖) |
| 数据采集 | psutil、smartctl、/proc 文件系统 |
| 容器化 | Docker |
---
## 📦 下载
| 资源 | 地址 |
|------|------|
| Docker 镜像 | `jpccr.ccs.tencentyun.com/jinghui/fnos-resmon:latest` |
| Gitea 仓库 | https://gitea.88531.cn/jinghui/fnos-resmon |
| FPK 包 | [Releases](https://gitea.88531.cn/jinghui/fnos-resmon/releases) |
---
## 🤝 贡献
欢迎 Issue 和 PR!
---
## 🔗 链接
- 资享导航站:https://nav.88531.cn - 资享导航站:https://nav.88531.cn
- 开源地址:https://gitea.88531.cn/jinghui/fnos-resmon - 开源地址:https://gitea.88531.cn/jinghui/fnos-resmon