Neko Master is een project dat is ontstaan om aan een heel specifieke behoefte te voldoen: inzicht krijgen in wat er op een lokaal netwerk gebeurt zonder een zware monitoringsysteem op te zetten of afhankelijk te zijn van externe services. Het biedt een modern dashboard voor het visualiseren en analyseren van netwerkverkeer in real-time, bedoeld voor lokale gateways en met ondersteuning voor meerdere backends.
Het project, gepubliceerd op GitHub door foru17 onder een MIT-licentie, definieert zichzelf als een tool voor het analyseren en visualiseren van verkeer. De makers benadrukken dat het geen toegang tot het netwerk biedt, geen proxy-abonnementen heeft en geen onderlinge netwerkconnectiviteit mogelijk maakt. Het verzamelt enkel gegevens uit de netwerkomgeving van de gebruiker en presenteert deze op een overzichtelijke manier om observatie, auditing en analyse te vergemakkelijken.
Deze aanpak past vooral goed bij omgevingen met OpenClash, Clash/Mihomo of Surge, waar al een gateway is die verkeer en regels beheert, maar waar nog niet altijd een gebruiksvriendelijk overzicht bestaat voor trends, domeinen, IP-adressen, nodes, verbindingen en gedrag in real-time.
Wat brengt Neko Master?
De kernbelofte van Neko Master is het bieden van zichtbaarheid. Het dashboard maakt het mogelijk om verkeer te monitoren via WebSocket met updates in real-time, trends te analyseren over windows van 30 minuten, 1 uur of 24 uur, verbruik per domein te bekijken, geassocieerde IP’s te raadplegen, informatie over ASN en geolocatie te bekijken en de verdeling van verkeer over proxy-nodes te analyseren.
Daarnaast ondersteunt het PWA-functionaliteit, dag- en nachtmodus, taalwissel tussen Engels en Chinees, en het gelijktijdig monitoren van meerdere backend-instanties. Dit laatste is vooral handig voor gevorderde gebruikers of kleine gedistribueerde netwerken die niet willen vertrouwen op een enkele gateway.
| Functie | Praktisch nut |
|---|---|
| Real-time monitoring | Verbindingen en verkeer met lage latentie bekijken |
| Analyse per domein | Detecteren welke services het meeste verkeer genereren |
| Analyse per IP | ASN, locatie en geassocieerde domeinen opvragen |
| Statistieken per proxy | Verkeer en verbindingen per node meten |
| Meerdere backends | Meerdere instanties via één dashboard beheren |
| PWA en donkere modus | Dashboard gebruiken als lichte desktop-app |
Het ontwerp is niet bedoeld om te concurreren met enterprise tools voor observability, SIEM of NetFlow. De waarde ligt in het bieden van een eenvoudige, visuele laag voor gebruikers die hun eigen netwerk beheren, zoals thuislaboratoria, persoonlijke gateways, routers met OpenWrt of kleine omgevingen waar snel inzicht gewenst is.
Implementatie met Docker en agent-modus
Neko Master kan op verschillende manieren worden geïnstalleerd. De aanbevolen methode is via Docker Compose, met een minimale configuratie die poort 3000 opent voor de webinterface. Voor real-time gebruik via WebSocket kan poort 3002 ook worden geopend en via reverse proxy of tunnel worden doorverwezen. Als WebSocket niet beschikbaar is, kan de app automatisch overschakelen op HTTP polling elke paar seconden.
Het project ondersteunt ook starten met docker run, installatie via een enkele script of vanaf de broncode met pnpm. In productiesettings raadt de documentatie aan om een variabele COOKIE_SECRET te gebruiken met een willekeurige string van minimaal 32 bytes, data-volumes persistent te maken en onnodige poorten niet bloot te stellen.
Een van de meest interessante features is de agent-modus. Deze stelt je in staat om een centraal Neko Master-dashboard te hebben, terwijl meerdere remote apparaten lokale gegevens verzamelen nabij elke gateway. De agent wordt geïnstalleerd op OpenWrt, Linux of macOS, verzamelt lokale informatie en stuurt deze naar het dashboard. Het voordeel is dat het dashboard niet direct contact hoeft te maken met de gateway, wat het eenvoudiger maakt in multi-locatie of streng beveiligde netwerken.
Voor Clash/Mihomo gateways kan WebSocket worden gebruikt voor data in real-time. Voor Surge v5+ gebeurt de data-acquisitie via HTTP polling, met vertragingen rond de twee seconden volgens de documentatie van het project.
Standaard SQLite en optioneel ClickHouse voor grote data
Neko Master gebruikt standaard SQLite als opslagmotor. Voor de meeste gebruikers is dat een goede keuze: eenvoudig, geen externe database vereist en geschikt voor het opslaan van configuraties, metadata en statistieken zonder complexe setup.
Voor situaties met grote datavolumes biedt het project een optionele integratie met ClickHouse. Aanbevolen wanneer er honderden duizenden domeinen of IP’s worden beheerd, snelle aggregaties over lange periodes nodig zijn, of wanneer je historisch verkeer gescheiden wilt opslaan van configuratiegegevens.
De modus met dual writing werkt zo dat SQLite configuratie en metadata opslaat, terwijl ClickHouse zich richt op statistische verkeersgegevens. Leesopties kunnen worden ingesteld op SQLite, ClickHouse of automatisch. Het ondersteunt ook een geleidelijke migratie: eerst schrijven in beide systemen terwijl er uit SQLite wordt gelezen, daarna automatisch lezen uit ClickHouse, en uiteindelijk, indien gewenst, overschakelen naar alleen ClickHouse met automatische fallback als de database uitvalt.
Deze aanpak maakt het toegankelijk: gebruikers die enkel een lokaal dashboard willen, kunnen bij SQLite blijven. Voor zware analyses op lange termijn is er schaalvergroting mogelijk.
Reverse proxy, security en projectbeperkingen
De documentatie adviseert om de web- en WebSocket-diensten op hetzelfde domein te hosten via routes: / voor poort 3000 en /_cm_ws voor poort 3002. Voorbeelden zijn er voor Nginx en Cloudflare Tunnel, en er worden veel voorkomende fouten besproken, zoals foutieve WebSocket-route of conflicten met Next.js statische routes.
Qua beveiliging ondersteunt Neko Master authenticatie om de ervaring te beveiligen. Aanbevolen wordt om COOKIE_SECRET in te stellen, FORCE_ACCESS_CONTROL_OFF alleen te activeren in herstelmodus, en SHOWCASE_SITE_MODE alleen te gebruiken voor publieke demo’s met beperkte gevoeligheid.
Belangrijk is te benadrukken wat Neko Master niet is: geen proxy-service, geen verkoop van toegang tot nodes, geen onderlinge netwerkconnectiviteit, en geen vervanging voor beveiligingsmaatregelen binnen een organisatie. Het is een tool voor visualisatie en analyse van data die binnen het eigen netwerk wordt verzameld. Dit voorkomt misverstanden, vooral omdat veel onderdelen (zoals gateways) mogelijk in configuraties met proxy gebruikt worden.
Een handige tool voor geavanceerde thuisnetwerken en kleine labs
De architectuur bestaat uit een Next.js-webapp, een Node.js Collector met Fastify en WebSocket, een Go-agent, SQLite-opslag met ClickHouse-optie en een gedeeld pakket met types en utilities. De frontend gebruikt Next.js 16, React 19, TypeScript, Tailwind CSS, shadcn/ui, Recharts en next-intl.
Deze combinatie plaatst het precies in een niche: geen commandolijnhulpmiddel of zware enterprise-dashboard, maar een moderne webapp voor technische gebruikers die verkeer overzichtelijk willen monitoren. Het is geschikt voor kleine netbeheerders, OpenWrt-enthousiastelingen, Clash/Mihomo- of Surge-gebruikers, thuislaboratoria en teams die snel inzicht willen krijgen in de werking van hun gateway.
De optionele ondersteuning voor ClickHouse en externe agenten onderstreept dat het project verder wil gaan dan een simpel dashboard. De uitgebreide documentatie over installatie, poorten, variabelen, reverse proxy, authenticatie, back-ups, architectuur en troubleshooting is een pluspunt.
Net als bij elke netwerktool is voorzichtigheid geboden: controleer welke data wordt verzameld, hoe deze wordt beschermd, wie toegang heeft tot het dashboard, welke poorten openstaan en of de gateway verbindingen vanaf de container of agent toestaat. Verkeerszichtbaarheid is waardevol, maar een slecht beveiligd dashboard kan gevoelige informatie prijsgeven over browsepatronen, gebruikte domeinen, nodes en verkeerpatronen.
Neko Master voorziet in een echte behoefte: inzichtelijk maken van netwerkverkeer zonder dat je een complexe stack hoeft op te zetten. Voor geavanceerde thuisnetwerken en kleine technische omgevingen kan het een zeer praktische oplossing worden. Het grootste voordeel ligt in de combinatie van eenvoudige uitrol, een moderne interface, real-time data, multi-gateway ondersteuning en de mogelijkheid tot opschaling naar ClickHouse bij toenemende data.
Veelgestelde vragen
Wat is Neko Master?
Neko Master is een open source dashboard voor het visualiseren en analyseren van netwerkverkeer in real-time binnen lokale gateway-omgevingen.
Is het een proxy of internettoegangsservice?
Nee. Het project verduidelijkt dat het geen proxy-diensten levert, geen toegang tot nodes verkoopt en geen onderlinge netwerkverbindingen faciliteert. Het richt zich enkel op het analyseren van zelf verzamelende gegevens.
Welke gateways worden ondersteund?
De documentatie vermeldt ondersteuning voor Clash/Mihomo (met WebSocket voor real-time data) en Surge v5+ (via HTTP polling).
Kan het met meerdere gateways worden gebruikt?
Zeker. Neko Master ondersteunt meerdere backends en ook een agentmodus om gegevens van remote devices op te halen.
Heb ik ClickHouse nodig?
Niet noodzakelijk. SQLite is de standaard opslag. ClickHouse is optioneel en bedoeld voor grote datablokken of uitgebreide historische analyses.