Neko Master Logo
Neko Master

Ve el tráfico de tu red con claridad.
Monitoreo en tiempo real · Auditoría de tráfico · Soporte multi-gateway

English | 中文

[!IMPORTANT] Aviso legal

Este proyecto es una herramienta de análisis y visualización de tráfico para entornos de gateway locales.

No proporciona ningún servicio de acceso a red, suscripción de proxy ni conectividad entre redes. Todos los datos se recopilan del propio entorno de red del usuario.

Este proyecto es de código abierto bajo la Licencia MIT. No asumimos ninguna responsabilidad por las consecuencias derivadas del uso de este software. Por favor, úsalo cumpliendo con las leyes y regulaciones aplicables.

Acerca del nombre

Neko (ねこ) significa gato en japonés. Se pronuncia /ˈneɪkoʊ/ (NEH-ko).

Como un gato, Neko Master observa el tráfico de red de forma silenciosa y precisa. Es un panel de análisis ligero diseñado para entornos de gateway modernos.

✨ Características

Característica	Descripción
📊 Monitoreo en tiempo real	Recopilación en tiempo real vía WebSocket con latencia de milisegundos
📈 Análisis de tendencias	Tendencias de tráfico multidimensionales: 30min / 1h / 24h
🌐 Análisis de dominios	Ver tráfico, IPs asociadas y número de conexiones por dominio
🗺️ Análisis de IP	Visualización de ASN, geolocalización y dominios asociados
🚀 Estadísticas de proxy	Distribución de tráfico y número de conexiones por nodo de proxy
📱 Soporte PWA	Instalar como aplicación de escritorio para una experiencia nativa
🌙 Modo oscuro	Soporte de tema Claro / Oscuro / Sistema
🌍 Soporte i18n	Cambio fluido entre inglés / chino
🔄 Multi-Backend	Monitorear múltiples instancias de backend de OpenClash simultáneamente

🚀 Inicio rápido

Opción 1: Docker Compose (Recomendado)

El docker-compose.yml incluido en el repositorio mapea 3000/3001/3002 por defecto. Los escenarios A/B a continuación son plantillas mínimas para despliegues comunes.

Escenario A: Despliegue mínimo (solo exponer 3000)```yaml

services: neko-master: image: foru17/neko-master:latest container_name: neko-master restart: unless-stopped ports: - "3000:3000" # Web UI volumes: - ./data:/app/data # Local MMDB (optional, files should be downloaded into ./geoip) - ./geoip:/app/data/geoip:ro environment: - NODE_ENV=production - DB_PATH=/app/data/stats.db - COOKIE_SECRET=${COOKIE_SECRET}

> Recomendado en `.env` (mismo directorio que `docker-compose.yml`):
> `COOKIE_SECRET=<cadena aleatoria de al menos 32 bytes>` (generar con `openssl rand -hex 32`)

> Este modo es totalmente compatible con actualizaciones y funciona sin configuración adicional.
> Si WS no está enrutado, la aplicación recurre automáticamente a HTTP polling.

#### Escenario B: WebSocket en tiempo real (recomendado con proxy inverso)```yaml
services:
  neko-master:
    image: foru17/neko-master:latest
    container_name: neko-master
    restart: unless-stopped
    ports:
      - "3000:3000" # Web UI
      - "3002:3002" # WebSocket (for Nginx / Tunnel forwarding)
    volumes:
      - ./data:/app/data
      # Local MMDB (optional, files should be downloaded into ./geoip)
      - ./geoip:/app/data/geoip:ro
    environment:
      - NODE_ENV=production
      - DB_PATH=/app/data/stats.db
      - COOKIE_SECRET=${COOKIE_SECRET}

Luego ejecuta:```bash docker compose up -d

Abre <http://localhost:3000> para comenzar.

Si utilizas el archivo Compose integrado del repositorio (por defecto `3000/3001/3002`), ejecuta el mismo comando.

neko-master