Neko Master：现代化的网络流量可视化分析面板

Neko Master：让你的网络流量一目了然

在日常的网络管理和运维工作中，了解网络流量的使用情况是一项基础但重要的需求。无论是家庭网络还是小型企业环境，能够清晰地看到流量走向、识别异常访问、审计网络使用情况，都是保障网络安全和优化网络性能的关键。Neko Master 作为一款现代化的网络流量可视化与分析工具，为这一问题提供了优雅的解决方案。

Neko Master 是一个专注于网络流量分析与可视化的开源项目，如同其名字中的 “Neko”（日语中意为"猫"）一样，它安静而敏锐，能够轻量、精确地对网络流量进行分析与可视化展示。

项目支持实时监控、流量审计、多网关管理，所有数据均来源于用户自有网络环境，不提供任何网络接入服务或代理订阅功能。

项目地址：https://github.com/foru17/neko-master

在线演示：https://neko-master.is26.com（访问密码：neko2026）

一、功能特性介绍

核心亮点

Neko Master 提供了完整的网络流量监控解决方案：

• 实时监控：通过 WebSocket 实现数据的实时推送，让流量变化一目了然
• 流量审计：详细记录和分析网络流量数据，支持历史查询和统计
• 多网关管理：支持同时管理多个网关的流量数据，适合复杂网络环境
• IP 地理位置查询：支持本地 MMDB 数据库或在线查询，了解流量来源
• 数据可视化：现代化的仪表盘界面，图表清晰直观

技术架构

项目采用现代化的技术栈构建：

• 前端：Next.js + React，提供流畅的用户体验
• 后端：Node.js，轻量高效
• 数据库：SQLite，无需额外数据库服务，数据存储简单可靠
• 容器化：完整的 Docker 支持，一键部署

安全与隐私

Neko Master 非常注重用户隐私和数据安全：

• 所有数据均来源于用户自有网络环境
• 不提供任何网络接入服务、代理订阅或跨网络连接功能
• 支持本地部署，数据完全由用户掌控
• 提供访问认证机制，保护面板安全

二、快速上手

方式一：Docker Compose（推荐）

最简部署方式，仅暴露 Web UI 端口：

services:
  neko-master:
    image: foru17/neko-master:latest
    container_name: neko-master
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
      - ./geoip:/app/data/geoip:ro
    environment:
      - NODE_ENV=production
      - DB_PATH=/app/data/stats.db
      - COOKIE_SECRET=${COOKIE_SECRET}

建议在 docker-compose.yml 同目录创建 .env 文件配置 Cookie 密钥：

COOKIE_SECRET=<至少32字节随机字符串>

使用 openssl rand -hex 32 生成安全的随机字符串。

启动服务：

docker compose up -d

访问 http://localhost:3000 即可看到管理面板。

方式二：实时 WebSocket 部署

如果需要实时数据推送功能，可以额外暴露 WebSocket 端口：

services:
  neko-master:
    image: foru17/neko-master:latest
    container_name: neko-master
    restart: unless-stopped
    ports:
      - "3000:3000"
      - "3002:3002"
    volumes:
      - ./data:/app/data
      - ./geoip:/app/data/geoip:ro
    environment:
      - NODE_ENV=production
      - DB_PATH=/app/data/stats.db
      - COOKIE_SECRET=${COOKIE_SECRET}

方式三：一键脚本

对于不熟悉 Docker 的用户，项目提供了自动检测端口冲突并配置的一键脚本：

curl -fsSL https://raw.githubusercontent.com/foru17/neko-master/main/setup.sh | bash

脚本会自动完成以下工作：

• 下载 docker-compose.yml 配置文件
• 检测默认端口（3000/3001/3002）是否被占用
• 提供可用的替代端口选项
• 创建配置文件并启动服务

方式四：源码运行

开发者可以选择源码方式运行：

git clone https://github.com/foru17/neko-master.git
cd neko-master
pnpm install
cp apps/collector/.env.example apps/collector/.env
pnpm dev

访问 http://localhost:3000 即可使用。

三、接入网关数据

Neko Master 支持接入多种网关的流量数据，以 Clash 为例：

1. 在 Clash 配置文件中添加 RESTful API 支持：

external-controller: 0.0.0.0:9090
secret: "your-secret"

2. 在 Neko Master 面板的设置页面添加网关配置：
   • 名称：自定义网关名称
   • 地址：Clash API 地址（如 http://192.168.1.1:9090）
   • 密钥：Clash 配置的 secret

添加完成后，面板会自动开始收集和展示该网关的流量数据。

四、总结

Neko Master 是一款设计优雅、功能实用的网络流量分析工具。从安装到使用，整个过程非常轻量化，通过 Docker 即可快速部署。

对于有网络流量监控需求的用户，无论是家庭网络管理还是小型企业运维，都可以尝试这个工具。它的实时监控和流量审计功能，能够帮助你更好地了解和管控网络使用情况。

项目遵循 MIT 协议开源，欢迎有开发能力的用户参与贡献。