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

> Neko-Master是一个功能强大的网络流量可视化分析面板，支持实时流量监控、数据包捕获、协议分析和图表化展示。本文介绍其架构设计、网络数据采集引擎、可视化仪表盘定制能力以及在企业网络运维和流量分析场景中的实际应用

- Canonical: https://www.zeroxin.xin/2026/02/17/Neko-Master-%E7%BD%91%E7%BB%9C%E6%B5%81%E9%87%8F%E5%8F%AF%E8%A7%86%E5%8C%96%E5%88%86%E6%9E%90%E9%9D%A2%E6%9D%BF/
- Published: 2026-02-17T10:00:00+08:00
- Updated: 2026-06-18T17:21:44+08:00

- Tags: 开源项目, 网络监控, 流量分析, Docker

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

<table>
  <tr>
    <td align="center" width="50%">
      <img src="https://github.com/xin-521/imgbed-storage/blob/main/neko-master-regions-light.png?raw=true" alt="Neko Master Preview (Light 1)" />
    </td>
    <td align="center" width="50%">
      <img src="https://github.com/xin-521/imgbed-storage/blob/main/neko-master-overview-light.png?raw=true" alt="Neko Master Preview (Light 2)" />
    </td>
  </tr>
  <tr>
    <td align="center" width="50%">
      <img src="https://github.com/xin-521/imgbed-storage/blob/main/neko-master-domains-dark.png?raw=true" alt="Neko Master Preview (Dark 1)" />
    </td>
    <td align="center" width="50%">
      <img src="https://github.com/xin-521/imgbed-storage/blob/main/neko-master-rules-dark.png?raw=true" alt="Neko Master Preview (Dark 2)" />
    </td>
  </tr>
</table>

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 端口：

```yaml
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 密钥：

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

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

启动服务：

```bash
docker compose up -d
```

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

## 方式二：实时 WebSocket 部署

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

```yaml
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 的用户，项目提供了自动检测端口冲突并配置的一键脚本：

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

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

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

## 方式四：源码运行

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

```bash
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 支持：

```yaml
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 协议开源，欢迎有开发能力的用户参与贡献。