Repolode
Enviar
foru17

foru17/neko-master

Un dashboard autohospedado para visualizar y auditar el tráfico de red de gateways con Clash/Mihomo (OpenClash) y Surge.

Ver en GitHub
Estrellas
4,215
Forks
270
Issues abiertos
14
Último commit
hace 12 días

¿Qué es?

Neko Master es un dashboard web para supervisar el tráfico que pasa por un gateway con Clash/Mihomo (incluido OpenClash) o Surge. Muestra el tráfico en tiempo real, las tendencias de los últimos 30 minutos, 1 hora y 24 horas, y vistas por dominio e IP con las IP asociadas, el número de conexiones, el ASN y la geolocalización. También desglosa el tráfico y las conexiones por nodo proxy y cadena de reglas.

La aplicación funciona como un recolector de Node.js con un frontend de Next.js; de forma predeterminada, guarda las estadísticas en SQLite y, de manera opcional, puede escribir también en ClickHouse para manejar grandes volúmenes de datos y consultas de períodos más largos. Las actualizaciones en tiempo real usan WebSocket y recurren al sondeo HTTP si no se puede acceder al puerto de WebSocket. Puede supervisar varios backends de gateway a la vez. Para gateways en máquinas remotas, un agente de Go se ejecuta cerca del gateway y envía los datos a un panel central, ya que el panel no se conecta directamente al gateway.

Se puede implementar mediante Docker Compose, Docker run, un script de instalación o desde el código fuente con pnpm. El control de acceso se basa en tokens, y la geolocalización de IP puede usar una API en línea o archivos MMDB locales de GeoLite2.

Funciones clave

  • 01Supervisión del tráfico en tiempo real mediante WebSocket, con sondeo HTTP como alternativa
  • 02Tendencias del tráfico en períodos de 30 minutos, 1 hora y 24 horas
  • 03Análisis por dominio e IP con ASN y geolocalización
  • 04Estadísticas de tráfico y conexiones por nodo proxy
  • 05Compatibilidad con varios backends de gateway de Clash/Mihomo y Surge
  • 06Almacenamiento opcional en ClickHouse además del SQLite predeterminado

Casos de uso

  • Comprobar a qué dominios e IP envía tráfico un gateway doméstico con OpenClash o Mihomo
  • Auditar el tráfico de Surge en varios dispositivos
  • Recopilar datos de gateways remotos OpenWrt o Linux mediante el agente
  • Revisar meses de historial de tráfico en ClickHouse cuando SQLite empieza a ir lento

Inicio rápido

  1. 1

    Genera un cookie secret para mantener la sesión

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

    Inicia el contenedor con Docker (configuración mínima, solo el puerto 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

    Abre http://localhost:3000 en el navegador para configurar tu gateway

Antes de usarlo

  • Las actualizaciones de WebSocket en tiempo real requieren que el puerto 3002 sea accesible a través del proxy inverso; de lo contrario, se recurrirá al sondeo.
  • Los datos de Surge se actualizan mediante sondeo HTTP, con un retraso aproximado de 2 segundos.
  • Es un panel de monitorización para tu propio gateway y requiere que haya un gateway Clash/Mihomo o Surge en funcionamiento para resultar útil.

En colecciones

Diagramas, gráficos y visualizaciones animadasPaneles y herramientas de inteligencia de negocioCursos y herramientas de ciencia de datos

Temas

#traffic-monitor#network-monitoring#dashboard#clash#mihomo#surge#openclash#data-visualization#visualization

Preguntas frecuentes

¿Qué es neko-master?
Un dashboard autohospedado para visualizar y auditar el tráfico de red de gateways con Clash/Mihomo (OpenClash) y Surge. Neko Master es un dashboard web para supervisar el tráfico que pasa por un gateway con Clash/Mihomo (incluido OpenClash) o Surge. Muestra el tráfico en tiempo real, las tendencias de los últimos 30 minutos, 1 hora y 24 horas, y vistas por dominio e IP con las IP asociadas, el número de conexiones, el ASN y la geolocalización. También desglosa el tráfico y las conexiones por nodo proxy y cadena de reglas.
¿neko-master es gratuito? ¿Qué licencia tiene?
neko-master es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿neko-master sigue mantenido?
Mantenimiento activo. El último commit de neko-master fue el 10 oct 2026.
¿Para qué puedo usar neko-master?
Comprobar a qué dominios e IP envía tráfico un gateway doméstico con OpenClash o Mihomo Auditar el tráfico de Surge en varios dispositivos Recopilar datos de gateways remotos OpenWrt o Linux mediante el agente Revisar meses de historial de tráfico en ClickHouse cuando SQLite empieza a ir lento
¿Cómo se instala neko-master?
Genera un cookie secret para mantener la sesión: export COOKIE_SECRET="$(openssl rand -hex 32)" Inicia el contenedor con Docker (configuración mínima, solo el puerto 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 Abre http://localhost:3000 en el navegador para configurar tu gateway
¿Dónde consigo neko-master?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/foru17/neko-master

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados