Neko Master es uno de esos proyectos que nacen para resolver una necesidad muy concreta: entender qué está pasando en una red local sin montar una pila pesada de monitorización ni depender de servicios externos. Su propuesta es un dashboard moderno para visualizar y analizar tráfico de red en tiempo real, pensado para entornos de gateway local y con soporte para múltiples backends.
El proyecto, publicado en GitHub por foru17 bajo licencia MIT, se define como una herramienta de análisis y visualización de tráfico. Sus propios responsables hacen una aclaración importante: no ofrece acceso a red, suscripciones proxy ni conectividad entre redes. Solo recoge datos del entorno de red del usuario y los presenta de forma ordenada para facilitar la observación, auditoría y análisis.
La idea encaja especialmente bien en entornos con OpenClash, Clash/Mihomo o Surge, donde ya existe un gateway gestionando tráfico y reglas, pero no siempre una interfaz cómoda para ver tendencias, dominios, IPs, nodos, conexiones y comportamiento en tiempo real.
Qué aporta Neko Master
La promesa principal de Neko Master es visibilidad. El panel permite observar tráfico con actualización en tiempo real mediante WebSocket, analizar tendencias en ventanas de 30 minutos, 1 hora o 24 horas, revisar consumo por dominio, consultar IPs asociadas, ver información de ASN y geolocalización, y analizar distribución de tráfico por nodos proxy.
También incluye soporte PWA, modo claro y oscuro, cambio de idioma entre inglés y chino, y capacidad para monitorizar varias instancias de backend simultáneamente. Esto último es relevante para usuarios avanzados o pequeñas redes distribuidas que no quieren limitarse a un único gateway.
| Función | Utilidad práctica |
|---|---|
| Monitorización en tiempo real | Ver conexiones y tráfico con baja latencia |
| Análisis por dominio | Detectar qué servicios consumen más tráfico |
| Análisis por IP | Consultar ASN, ubicación y dominios asociados |
| Estadísticas por proxy | Medir tráfico y conexiones por nodo |
| Multi-backend | Supervisar varias instancias desde un panel |
| PWA y modo oscuro | Usar el dashboard como app de escritorio ligera |
El diseño no pretende sustituir a herramientas empresariales de observabilidad, SIEM o NetFlow. Su valor está en acercar una capa visual clara a usuarios que gestionan su propia red, laboratorios domésticos, gateways personales, routers con OpenWrt o entornos pequeños donde interesa ver rápido qué ocurre.
Despliegue con Docker y modo agente
Neko Master ofrece varias formas de instalación. La recomendada es Docker Compose, con una configuración mínima que expone el puerto 3000 para la interfaz web. Para una experiencia en tiempo real con WebSocket, también puede exponerse el puerto 3002 y enrutarlo mediante proxy inverso o túnel. Si WebSocket no está disponible, la aplicación puede caer automáticamente a polling HTTP cada pocos segundos.
El proyecto también permite arrancar con docker run, instalar mediante script de un solo comando o ejecutarse desde código fuente con pnpm. En despliegues de producción, la documentación recomienda fijar una variable COOKIE_SECRET con una cadena aleatoria de al menos 32 bytes, persistir el volumen de datos y no exponer innecesariamente puertos internos.
Una de las partes más interesantes es el modo agente. Sirve cuando se quiere tener un panel central de Neko Master y varios dispositivos remotos recogiendo datos cerca de cada gateway. El agente se instala en OpenWrt, Linux o macOS, recoge información local y la reporta al panel. La ventaja es que el panel no necesita conectarse directamente al gateway, lo que simplifica escenarios con varias ubicaciones o redes más cerradas.
En gateways Clash/Mihomo, el sistema puede usar WebSocket para datos en tiempo real. En Surge v5 o superior, la recogida se hace mediante HTTP polling, con un retraso aproximado de unos dos segundos según la documentación del proyecto.
SQLite por defecto y ClickHouse para grandes volúmenes
Neko Master usa SQLite como motor de almacenamiento por defecto. Para la mayoría de usuarios, esa elección tiene sentido: es simple, no requiere operar una base de datos externa y permite guardar configuración, metadatos y estadísticas sin complicar el despliegue.
Para casos con volúmenes grandes, el proyecto ofrece integración opcional con ClickHouse. La documentación lo recomienda cuando se manejan cientos de miles de dominios o IPs, cuando hacen falta agregaciones rápidas sobre periodos largos, o cuando se quiere separar el almacenamiento histórico de tráfico del almacenamiento de configuración.
El modo ClickHouse funciona con escritura dual: SQLite sigue guardando configuración y metadatos, mientras ClickHouse almacena datos estadísticos de tráfico. La fuente de lectura puede configurarse como SQLite, ClickHouse o automática. También existe una ruta gradual de migración: primero escribir en ambos sistemas mientras se lee de SQLite, después activar lectura automática o desde ClickHouse, y finalmente, si se desea, pasar a modo solo ClickHouse con fallback automático si ClickHouse deja de estar disponible.
Este enfoque es sensato porque no obliga a todos los usuarios a desplegar ClickHouse desde el primer minuto. Quien solo quiere un panel local puede quedarse en SQLite. Quien necesita análisis histórico más pesado tiene una salida de crecimiento.
Proxy inverso, seguridad y límites del proyecto
La documentación recomienda servir web y WebSocket bajo el mismo dominio mediante rutas: / hacia el puerto 3000 y /_cm_ws hacia el 3002. Incluye ejemplos para Nginx y Cloudflare Tunnel, y advierte de errores comunes, como colocar mal la ruta WebSocket o usar rutas que interfieran con archivos estáticos de Next.js.
En seguridad, Neko Master soporta autenticación para proteger los datos del panel. El proyecto recomienda fijar COOKIE_SECRET, no dejar activado FORCE_ACCESS_CONTROL_OFF salvo en modo de recuperación, y usar SHOWCASE_SITE_MODE solo en demos públicas, donde se restringen operaciones sensibles.
Es importante insistir en lo que Neko Master no es. No es un servicio proxy, no vende acceso a nodos, no crea conectividad entre redes y no sustituye a controles de seguridad de una organización. Es una herramienta de visualización y análisis para datos recogidos dentro del entorno del usuario. Esa delimitación ayuda a evitar malentendidos, especialmente porque muchas piezas del proyecto se conectan con gateways usados habitualmente en configuraciones proxy.
Una herramienta interesante para redes domésticas avanzadas y pequeños laboratorios
La arquitectura está dividida en una aplicación web Next.js, un servicio collector en Node.js con Fastify y WebSocket, un agente en Go, almacenamiento SQLite con opción de ClickHouse y un paquete compartido de tipos y utilidades. El frontend usa Next.js 16, React 19, TypeScript, Tailwind CSS, shadcn/ui, Recharts y next-intl.
Esa combinación lo sitúa en una categoría muy concreta: no es una utilidad de línea de comandos ni un dashboard empresarial pesado, sino una aplicación web moderna para usuarios técnicos que quieren observar tráfico de forma cómoda. Puede ser útil para administradores de redes pequeñas, entusiastas de OpenWrt, usuarios de Clash/Mihomo o Surge, laboratorios domésticos y equipos que necesitan una capa visual rápida sobre el comportamiento del gateway.
La presencia de ClickHouse opcional y agente remoto muestra que el proyecto quiere ir más allá de un panel simple. También es positivo que la documentación cubra instalación, puertos, variables, proxy inverso, autenticación, recuperación de token, backups, arquitectura y troubleshooting.
Como siempre en herramientas de red, la adopción debería hacerse con prudencia. Conviene revisar qué datos se recogen, cómo se protegen, quién accede al panel, qué puertos quedan expuestos y si el gateway permite conexiones desde el contenedor o desde el agente. La visibilidad es valiosa, pero un panel mal protegido puede revelar información sensible sobre hábitos de navegación, dominios consultados, nodos usados y patrones de tráfico.
Neko Master apunta a una necesidad real: hacer comprensible el tráfico de red sin obligar al usuario a montar una pila compleja. Para redes domésticas avanzadas y entornos técnicos pequeños, puede convertirse en una herramienta muy práctica. Su mayor atractivo está en combinar despliegue sencillo, interfaz moderna, tiempo real, soporte multi-gateway y una ruta de escalado hacia ClickHouse cuando los datos crecen.
Preguntas frecuentes
¿Qué es Neko Master?
Neko Master es un dashboard open source para visualizar y analizar tráfico de red en tiempo real en entornos de gateway local.
¿Sirve como proxy o servicio de acceso a internet?
No. El proyecto aclara que no proporciona servicios proxy, suscripciones ni conectividad entre redes. Solo analiza datos del entorno del usuario.
¿Qué gateways soporta?
La documentación menciona soporte para Clash/Mihomo mediante WebSocket en tiempo real y Surge v5+ mediante HTTP polling.
¿Puede usarse con varios gateways?
Sí. Neko Master soporta múltiples backends y también modo agente para recoger datos desde dispositivos remotos.
¿Necesita ClickHouse?
No. SQLite es el almacenamiento por defecto. ClickHouse es opcional y está pensado para grandes volúmenes de datos o consultas históricas más pesadas.
