foru17/neko-master

这是什么？

核心功能

• 01通过 WebSocket 实时监控流量，端口不可达时回退到 HTTP 轮询
• 02提供 30 分钟、1 小时和 24 小时的流量趋势
• 03按域名和 IP 分析，显示 ASN 与地理位置
• 04统计每个代理节点的流量和连接数
• 05同时支持多个 Clash/Mihomo 与 Surge 网关后端
• 06可选 ClickHouse 存储，默认使用 SQLite

适用场景

• 查看家中 OpenClash 或 Mihomo 网关的流量都访问了哪些域名和 IP
• 审计多台设备经由 Surge 产生的流量
• 通过 Agent 从远程 OpenWrt 或 Linux 网关采集数据
• 在 SQLite 变慢时，使用 ClickHouse 查询较长时间范围的历史流量

快速上手

1. 1

   生成用于会话持久化的 Cookie 密钥

   export COOKIE_SECRET="$(openssl rand -hex 32)"
2. 2

   使用 Docker 启动容器（最小化部署，仅端口 3000）

   docker run -d --name neko-master -p 3000:3000 -v $(pwd)/data:/app/data -e COOKIE_SECRET="$COOKIE_SECRET" --restart unless-stopped foru17/neko-master:latest
3. 3

   在浏览器中打开 http://localhost:3000 以配置网关

使用前须知

• !实时 WebSocket 更新需要反向代理能够访问 3002 端口，否则会回退为轮询。
• !Surge 通过 HTTP 轮询获取数据，刷新延迟约 2 秒。
• !这是用于监控自有网关的仪表盘，需要运行中的 Clash/Mihomo 或 Surge 网关才能使用。

收录于专题

标签

常见问题

neko-master 是什么？

自托管的网络流量可视化面板，用于监控和审计 Clash/Mihomo（OpenClash）与 Surge 网关的流量。 Neko Master 是一个网页版流量面板，用于查看经过 Clash/Mihomo（包括 OpenClash）或 Surge 网关的网络流量。它提供实时流量曲线、30 分钟、1 小时和 24 小时的趋势分析，并可按域名或 IP 查看关联地址、连接数、ASN 和地理位置，还能按代理节点统计流量与连接。

neko-master 可以免费使用吗？用的什么许可证？

neko-master 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

neko-master 还在维护吗？

活跃维护中。neko-master 最近一次提交是在 2026年10月10日。

neko-master 适合用来做什么？

查看家中 OpenClash 或 Mihomo 网关的流量都访问了哪些域名和 IP 审计多台设备经由 Surge 产生的流量 通过 Agent 从远程 OpenWrt 或 Linux 网关采集数据 在 SQLite 变慢时，使用 ClickHouse 查询较长时间范围的历史流量

neko-master 怎么安装和运行？

生成用于会话持久化的 Cookie 密钥: export COOKIE_SECRET="$(openssl rand -hex 32)" 使用 Docker 启动容器（最小化部署，仅端口 3000）: docker run -d --name neko-master -p 3000:3000 -v $(pwd)/data:/app/data -e COOKIE_SECRET="$COOKIE_SECRET" --restart unless-stopped foru17/neko-master:latest 在浏览器中打开 http://localhost:3000 以配置网关

在哪里获取 neko-master？

源代码和安装说明在 GitHub 上：https://github.com/foru17/neko-master