🐱 Neko Master：开源网络流量面板 Clash/Surge实时监控

Neko Master 是开源自部署网络流量分析面板，支持 OpenClash/Mihomo/Surge 多网关，WebSocket 实时采集。面板+Agent 分布式架构，ClickHouse 大规模分析后端，PWA 桌面端体验，MIT 开源免费，文末附详细使用教程

🎤 引言

家里用了 OpenClash / Mihomo / Surge，但你真的知道这些流量都跑哪去了吗？

看 Stat Panel 是看，但大部分面板 UI 实在太丑了——配色土、字体糊、图表像 Excel 截图。最常见的情况是：装完面板三天后吃灰，流量还是糊里糊涂地跑。

罗磊用 4 小时 Vibe Coding 出 Neko Master，解决的就是这个痛点：一个开源、自部署、长得还不错的网络流量分析面板。

「Like a cat, Neko Master observes network traffic quietly and precisely.」——像猫一样安静而精确地观察流量，这是项目自我定位。

GitHub 上 3k Stars，199 Forks，175 个 commit，最新版本 v1.4.0。它解决了从 0 到「能用」「能看」「能定位问题」的所有核心场景。

⭐ 核心功能

📊 实时流量监控

WebSocket 实时采集，毫秒级延迟。在面板上看到的流量数据就是此时此刻发生的事情，不是 N 分钟前的历史快照。

30 分钟 / 1 小时 / 24 小时 三个时间维度趋势分析
代理节点流量分布：哪个节点用得多、连接数多少
域名/IP 关联分析：看到「油管」就知道背后解析到了哪些 IP

🌐 多网关支持

网关类型	支持情况	采集方式
OpenClash	✅ 完整	WebSocket 实时
Mihomo	✅ 完整	WebSocket 实时
Surge v5+	✅ 完整	HTTP 轮询

未来可能接入更多网关类型——项目早期叫「Clash Master」，改名 Neko Master 的原因之一就是不想绑定单一生态。

🚀 ClickHouse 大规模分析后端

可选组件。ClickHouse 专为 OLAP 场景设计，处理几亿条流量记录毫无压力。

默认配置用 SQLite，但如果你需要：

长期历史数据存储（超过 30 天）
复杂多维度查询
大规模节点部署

→ 建议上 ClickHouse，v1.4.0 已经把 ClickHouse 集成打磨成可选插件式开启。

🏗️ Agent 分布式架构

这是 Neko Master 最有意思的架构设计：

[OpenWrt 软路由]  ────►  [neko-agent]  ────►  [Neko Master 面板]  ◄───  [NAS]
[Linux 盒子]    ────►  [neko-agent]  ────►  
[macOS 设备]    ────►  [neko-agent]  ────►

面板从不直接连接网关：避免在 OpenWrt 上开复杂端口映射
Agent 跑在网关附近：直接读取 Clash/Mihomo 的 WebSocket 流量
面板统一汇总：从多个 Agent 收集数据，集中展示

这在 NAS / 软路由 / 边缘计算节点上特别好用——面板跑在你的 NAS 上，Agent 跑在网关附近，资源占用合理。

📱 PWA 桌面端体验

不是 Electron 桌面应用，是 PWA（渐进式 Web 应用）：

浏览器直接「安装」到桌面
像原生 App 一样有图标、启动器、独立窗口
不占额外空间，不发热，吃资源少
跨平台（Windows/macOS/Linux 通吃）

📥 安装与使用

方式一：Docker 一键部署（推荐）

docker run -d \
  --name neko-master \
  -p 7890:7890 \
  -v neko-data:/app/data \
  --restart unless-stopped \
  ghcr.io/foru17/neko-master:latest

启动后访问 http://localhost:7890，默认账号 neko，密码 neko2026（登录后请改）。

方式二：源码部署

git clone https://github.com/foru17/neko-master.git
cd neko-master

# 安装依赖
pnpm install

# 启动开发环境
pnpm dev

# 生产构建
pnpm build

项目用 pnpm workspaces monorepo 管理：

apps/web — 面板前端
apps/api — 后端 API
apps/agent — 网关端 Agent
packages/shared — 共享类型

部署 Agent（OpenWrt 示例）

# 在 OpenWrt 上
opkg update
opkg install curl

# 下载 agent
curl -L https://github.com/foru17/neko-master/releases/latest/download/neko-agent-linux-arm64 -o /usr/bin/neko-agent
chmod +x /usr/bin/neko-agent

# 配置启动
/usr/bin/neko-agent \
  --panel-url http://你的NAS-IP:7890 \
  --gateway clash \
  --gateway-url http://127.0.0.1:9090

🎯 适用场景

特别适合：

🏠 家庭网络深度玩家：用 OpenClash/Mihomo 跑代理，需要看清流量细节
🖥️ NAS 用户：用群晖/威联通做软路由，需要面板统一监控
🛜 小型工作室：多人共用一个网关，需要区分每个人的流量
🎓 网络学习者：研究代理协议、DNS 解析、流量分布
🌐 跨境业务开发者：实时监测代理节点的健康度

不太适合：

☁️ 云服务器运维监控（Neko Master 定位是网关，不是 SaaS 监控）
🏢 企业级流量审计（涉及合规审计请用专业方案）
📡 路由器固件自带面板（如果你对当前面板满意，不折腾也行）

🔍 对比/替代方案

工具	类型	颜值	多网关	历史数据	部署难度
Neko Master	开源自部署	⭐⭐⭐⭐⭐	Clash/Mihomo/Surge	SQLite/ClickHouse	⭐⭐ (Docker)
Yacd	开源面板	⭐⭐⭐	Clash	无	⭐⭐
Dashboard-acl	开源面板	⭐⭐⭐⭐	Mihomo	基础	⭐⭐
LuCI App (OpenClash)	路由原生	⭐⭐⭐	OpenClash	弱	⭐ (已装)
UniFi 控制器	商业	⭐⭐⭐⭐⭐	UniFi 设备	强	⭐⭐⭐

关键差异：Neko Master 在「颜值 + 多网关 + 可扩展性」三角中找到了平衡点——比 Yacd 好看 10 倍，比 LuCI 原生面板扩展性强 100 倍，又不像 UniFi 那样绑定设备。

⚠️ 注意事项

首次部署需要一点学习成本
- 面板虽然开箱即用，但 Agent 部署需要看架构文档
- 推荐先在本地 Docker 跑通，再部署到 NAS
v1.4.0 仍在快速迭代
- 20 个 open Issues，5 个 open PRs，社区活跃
- 大版本更新前建议备份 data/ 目录
- CHANGELOG 用中文 + 英文双语，变更清晰
默认密码务必修改
- 内置账号 neko:neko2026 仅供测试
- 第一次登录后必须改密码
- 项目内置 Auth 鉴权 + Security defaults
Agent 网关连接安全
- Agent → 面板是单向推送，不需要暴露网关端口
- 但面板 → Agent 反向拉取可能需要 token 鉴权
- 详细看安全模型文档
开发工具版权说明
- 项目本身 MIT 协议完全开源
- 但项目是用 Kimi K2.5 + Claude Code Opus 4.6 + CodeX Vibe Coding 出来的
- 商业使用没问题，但别拿去打 AI 培训班的招牌

✅ 总结

Neko Master 解决的是一个很多人有需求、但很少人做好的事：让 OpenClash/Mihomo 用户的网络可视化体验升级。

它的优势不只是「好看」，更是「好用」——分布式 Agent 架构解决了「面板装哪里」的问题，ClickHouse 后端解决了「数据存多久」的问题，PWA 解决了「怎么访问」的问题。

而且它有一个隐藏优势：作者是 Vibe Coding 的真实受益者。4 小时从零到 1k Stars，这套方法论（Kimi 铺功能 + Claude/CodeX 啃架构）值得每一个想快速验证想法的人学习。

适合人群：家里用代理网关、想看清流量的技术用户。
不适合人群：不用代理网关、不需要看流量细节的人。

如果你已经用着 OpenClash/Mihomo，对现状不满但又懒得换——试试 Neko Master，半小时部署，看一周数据，你会回来感谢我的。

推荐指数：⭐⭐⭐⭐⭐（5/5，网络玩家的 Dashboard 新标杆）

📦 项目地址：https://github.com/foru17/neko-master
📜 许可证：MIT（开源免费）
🐳 Docker：ghcr.io/foru17/neko-master