Funktionen

Alles, was NetPulse sehen kann

Eine vollständige Liste dessen, was die App überwacht, und die Begründung hinter den technischen Entscheidungen.

Funktionsübersicht

Vom Netzwerk zur Oberfläche

NetPulse liest Daten von deinen Routern und zeigt sie auf einem Bildschirm. Das Polling ist read-only; alles, was schreibt, ist explizit und durch Rollback abgesichert.

Gesundheitspanel

Ein Wert von 0-100, der Latenz, Verlust, Uptime und Temperatur verdichtet. Daneben der Live-WAN-Durchsatz gegen deinen Vertragstarif, durchschnittliche Latenz und verbundene Geräte.

  • Gesundheitswert 0-100 mit gewichteter Berechnung pro Router
  • WAN-Durchsatz, Tagespeak, 24-h-Durchschnitt und Gesamt
  • Live-Updates per SSE alle ~5 s
Verfügbar

Live-Topologie

Semantische Karte, gebaut aus der Bridge-FDB und LLDP, wenn verfügbar. Zeichnet Router, Switches, Hypervisoren, verschachtelte Container, kabelgebundene und WLAN-Clients und WireGuard-Tunnel. Und wenn die Inferenz nicht wissen kann, wo etwas eingesteckt ist, heftest du jedes Gerät von Hand an seinen genauen Router und Port.

  • Inferenz verwalteter und erschlossener Switches
  • Hypervisoren mit sichtbaren verschachtelten Containern
  • Verkehrsanimation und Link-Status
  • Bearbeitungsmodus: Knoten ziehen und Layout speichern
Verfügbar

Geräte

Jeder Client automatisch nach Hostname-Mustern und OUI klassifiziert, mit Band, Signal in dBm, Erstauftauchen und dem Router oder Port, mit dem er spricht.

  • Klassifizierung nach Typ: Computer, Handy, IoT, Kamera, Konsole ...
  • Band (2,4 GHz / 5 GHz / Kabel) und Signal
  • Online-/Offline-Status und Erstauftauchen
Verfügbar

Router-Flotte

Flottenweite Ansicht aller deiner Router mit CPU, Speicher, Temperatur, Uptime, verbundenen Clients und einer 24-h-Last-Sparkline. SNMP-gepollte verwaltete Switches sind ebenfalls Bürger erster Klasse, mit eigener Verkehrshistorie und eigenen Clients.

  • Karte pro Router mit Rolle (Gateway / AP / Switch)
  • Eine Einheit pausieren ohne sie zu löschen: kein Polling, keine Alerts, Historie bleibt
  • LLDP-MIB auf SNMP-Switches: echte Uplinks ohne OpenWrt
Verfügbar

Agent und Updates

Der Agent ist ein natives OpenWrt-Paket (.ipk und .apk, von mips bis x86/64) mit procd-Init, UCI-Config und Watchdog. Der Server installiert und aktualisiert die ganze Flotte aus der UI und rotiert Tokens im Betrieb, ohne Neuinstallation.

  • Agent aus der Server-UI installieren
  • Warnung bei veraltetem Agent und Upgrade-Button
  • Reaktivierung und Agent-Status in Echtzeit
  • owut check: Prüfen, ob dein Router ein Firmware-Update hat
  • Firmware-Upgrades aus der UI, nur vanilla OpenWrt
Verfügbar

WLAN und Roaming

Signalmatrix zwischen APs und Clients, Roaming-Events 30 Tage lang aufbewahrt, und Werkzeuge, um klebrige Clients neu zu verankern oder von einem AP zu werfen, damit sie einen besseren wählen.

  • Assoziations-/Disassoziations- und Roaming-Events
  • Re-Anker-Empfehlung nach Signal
  • Steering-Migration von DAWN zu usteer
Verfügbar

Wi-Fi-Kanal-Analyse

Ein echtes Spektrum pro Radio: jedes Netz als Glocke auf der Frequenzachse, DFS-Bereiche schattiert, dazu ein kontinuierlicher Belegungsstreifen. Dein Netz, so wie die Luft es sieht.

  • Congestion-Score pro Kanal (optimal, moderat, belegt); Klick zum Fokussieren
  • Eigene Netze belegen nie einen Kanal (Erkennung über MAC, SSID und dawn/usteer)
  • Schlägt nur vor: den Kanal anzuwenden bleibt bei dir, am Router
Verfügbar

Switch-Port-Detail

Ansicht pro Port der Switches: ausgehandelte Geschwindigkeit, Verkehr, Fehler, Link-Status und spezifische Alarme wie Geister-Port, Flapping oder degradierte Geschwindigkeit.

  • Zeitreihen des Verkehrs pro Port
  • Alarme für Geister-Port, Flapping und degradierten Link
  • Frontpanel des Switch
Verfügbar

WireGuard

Peer-Liste, letzte Handshakes, Transfer pro Peer und Tunnel auf der Topologiekarte gezeichnet, wobei jeder Peer mit seinem echten Namen aus der UCI-Konfiguration beschriftet ist.

  • Status jedes Peers und Zeit seit dem letzten Handshake
  • Akkumuliertes RX/TX pro Tunnel
  • Visualisierung des Tunnels vom Internet bis zum Gateway
Verfügbar

AdGuard Home

DNS-Abfragestatistiken, Blockanteil, meistgeblockte Domains und welche Clients den Filter nutzen, alles neben dem Rest des Netzwerks.

  • Abfragen und Blocks über 24 h
  • Top der geblockten Domains
  • Durchschnittliche DNS-Latenz
Verfügbar

Alarme

Sechs Kategorien mit Dringlichkeit pro Kategorie: Temperatur, verfügbare Firmware, neues Gerät, WireGuard-Handshake, Netzwerkport und Roaming-Events. Feed in der Glocke und Web-Push-Benachrichtigungen.

  • Persistenter Feed mit automatischer Auflösung
  • Natives Web Push per VAPID, ohne Dritte
  • Handlungsvorschläge bei Port-Alarmen
Verfügbar

Berichte

Tägliche, wöchentliche und monatliche Verfügbarkeitsberichte pro Router und pro Gerät. In Entwicklung: Verkehr, Aktivität, Alarmzusammenfassung und Export.

  • Verfügbarkeit pro Router und Gerät
  • Tägliche, wöchentliche und monatliche Ansichten
  • CSV/JSON-Export geplant
Teilweise / in Entwicklung

Einstellungen

Eine Spalte mit einem klebrigen Index, der dir beim Scrollen folgt: Benutzer und Rollen, Sprache pro Benutzer, Erscheinungsbild mit echten Vorschauen, Datenschwellen, Router, Dienste und Integrationen, Orchestrierung und Auto-Updates.

  • Benutzer mit Rollen und bcrypt
  • Echter WAN-Geschwindigkeitstest, vom Server aus ausgeführt
  • Auto-Update mit Changelog
Verfügbar

Demo-Modus

DEMO_MODE=1 startet ein vollständiges Beispielnetzwerk mit 67 Geräten, ohne echte Router. Nützlich, um die UI vor der Installation zu testen.

  • Kanonischer Datensatz mit 67 Geräten
  • Gleiche Oberfläche wie im echten Modus
  • Öffentliche Live-Demo unter demo.netpulse.cloudless.club
Verfügbar

LuCI-App

luci-app-netpulse integriert den Agent-Status in die OpenWrt-Weboberfläche: procd, UCI, Logs, Neustart und einen Link zur Haupt-App.

  • Agent-Status in LuCI
  • Agent neu starten und reaktivieren
  • .ipk/.apk-Paket in jedem Release
Verfügbar

On-Box-Modus

Wenn du keine extra Kiste hast, kann der Server direkt auf dem OpenWrt-Router laufen, mit UCI-Config, TLS-Pinning und lokalem Pairing.

  • Statische Binärdatei für kompatible Router
  • Native UCI-Config
  • Selbstsigniertes Zertifikat mit SPKI-Pinning
  • Optionales HTTPS für die UI: deine Zertifikate oder selbstsigniert
Verfügbar

KI-Assistent (MCP)

Ein MCP-Server unter /mcp: dein KI-Assistent fragt Flottenstatus, Geräte, Alerts und die Topologie über HTTP mit einem API-Token ab. Nur-Lese-Werkzeuge auf dem letzten Poll.

  • Flottenstatus, Router-Gesundheit, Geräte, WireGuard-Peers, AdGuard, Topologie und Alerts
  • Nur API-Tokens (nie das Session-Cookie), mit Rate-Limit
  • Jeder Werkzeug-Aufruf wird für die Prüfung protokolliert
Verfügbar

Physisches Rack

Zeichne dein 19-Zoll-Rack, platziere Router, Switches und Server nach Höheneinheit, und lass NetPulse die Verkabelung aus der erkannten Topologie vorschlagen, Router-zu-Router-Uplinks inklusive. Sehr frühe Vorschau.

  • Racks und Montagen mit echten Höheneinheiten und 19-Zoll-Proportionen
  • Verkabelung aus dem FDB vorgeschlagen; importierte Kabel werden als erkannt markiert
  • Standardmäßig aus: aktivieren in Einstellungen, Labs
Labs (experimentell)

NetPulse und Home Assistant

NetPulse veröffentlicht den Flottenstatus auf einem MQTT-Broker, und Home Assistant erkennt ihn von selbst: Es legt die Geräte und ihre Entitäten an, ohne dass du irgendetwas von Hand definierst. Alles geschieht in deinem lokalen Netzwerk.

  • Die gesamte Installation
  • Jeder Router, für sich
  • Den Router aus Home Assistant steuern
Verfügbar Home Assistant
Technische Entscheidungen

Warum es so gebaut wurde

NetPulse ist kein Marketingprodukt: Es ist ein persönliches Werkzeug, das gebaut wurde, um echte Probleme zu lösen. Das sind die Entscheidungen, die am häufigsten gefragt werden.

Warum OpenWrt / GL.iNet?

NetPulse entstand aus einem Heimnetzwerk mit vier Routern: einem GL.iNet Flint 2 als Gateway und drei gebrauchten Xiaomi AX6. OpenWrt erlaubt es, die Hardware zu flashen, zu inspizieren und zu steuern. Ohne das gäbe es keine Möglichkeit, die FDB, iwinfo oder iw-Events zu lesen, die die App speisen.

Warum Go + eingebettetes SQLite?

Eine einzige statische Binärdatei mit deaktiviertem CGO. Keine C-Toolchain auf dem Ziel nötig, Updates per atomarem Swap, und Benutzer, Sitzungen und Zeitreihen in einem lokalen SQLite mit WAL. modernc.org/sqlite macht es vollständig statisch.

Warum ist das Polling read-only?

Der Server erzeugt sein eigenes ed25519-Schlüsselpaar, und du autorisierst den öffentlichen Schlüssel auf jedem Router. Von da an liest das Polling nur: ubus, /proc, iwinfo, bridge fdb, wg show. Schreibende Aktionen (eine IP reservieren, ein Gerät sperren, Dienste orchestrieren, Firmware flashen) sind immer explizit, vom Admin ausgelöst und werden mit Snapshot und automatischem Rollback angewendet.

Warum systemd und nicht Docker?

NetPulse überwacht ein Netzwerk; es braucht dafür keinen Container. Eine abgeschottete systemd-Unit mit einfacher Service-Datei, journald-Logs und automatischem Neustart ist leichter und einfacher zu betreiben, auf einem kleinen LXC oder einer VM.

Warum PWA + SSE?

Die UI ist eine React-SPA mit Vite und Tailwind, die sich als PWA installiert. Das Backend pusht Live-Events per SSE alle ~5 s. Kein ständiges Polling, kein WebSocket: SSE ist unidirektional, verbindet sich selbst neu und funktioniert gut hinter Heim-Proxys.

Warum von DAWN zu usteer?

Wir starteten mit DAWN für das WLAN-Steering, weil es die sichtbarste Option in der OpenWrt-Community war. In echten Netzwerken sahen wir, dass es Authentifizierungen in einer Kette verweigern, Clients unerwartet werfen und ungelöste Bugs im Peer-to-Peer-Modell behalten konnte. usteer ist der offizielle OpenWrt-Daemon mit gleichwertigen Funktionen und einem stabileren Modell. Die Migration zu usteer läuft und behält die gleiche Roaming-Sichtbarkeit.

Was NetPulse nicht ist

Es ist wichtig, ehrlich über den Umfang zu sein. NetPulse gibt nicht vor, Folgendes zu sein:

  • Ein Enterprise-NMS wie Zabbix, LibreNMS oder PRTG. Es skaliert nicht auf Tausende Knoten und unterstützt keine Tausende SNMP-MIBs.
  • Eine Cloud-Lösung. Es gibt keine Telemetrie, keine zentralen Dashboards und keine nativen mobilen Apps.
  • Ein Werkzeug zur massenhaften automatischen Konfiguration. Orchestrierung existiert, ist aber opt-in und planbasiert.
  • Eine universelle Router-Lösung. Es ist auf OpenWrt / GL.iNet getestet; andere Firmwares bräuchten Anpassung.
Erscheinungsbild
Thema