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.

Each card folds open with a click.

Gesundheitspanel

Your whole network, condensed into one number.

Verfügbar

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

WAN speed tests

Your connection, measured over time.

Verfügbar

Run a test from the server when you need one, or schedule it by interval, weekly, monthly, or at the quietest hour based on the last seven days. Results are stored in SQLite and shown in a one-week chart and a run history.

  • M-Lab NDT by default, with Ookla, Cloudflare, LibreSpeed and custom HTTP endpoints
  • Manual runs from Overview or Settings
  • Alert when download speed falls below your chosen percentage of the contracted plan

Live-Topologie

The map your network draws by itself.

Verfügbar

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
  • Evidence-Tag an jedem Uplink: LLDP, FDB, Device-Zuordnung oder manuelles Override

Geräte

Every device named, classified and located, without lifting a finger.

Verfügbar

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, Telefon, IoT, Kamera, Saugroboter, Türklingel, Klimaanlage, Boiler, SBC...
  • Band (2,4 GHz / 5 GHz / Kabel) und Signal
  • Online-/Offline-Status und Erstauftauchen
  • Opt-in Offline-Warnungen: Client markieren und einen dringenden Push bekommen, wenn er wirklich abbricht

Router-Flotte

Your whole fleet on one wall, load included.

Verfügbar

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

Agent und Updates

Installs from the UI, updates itself, reports in real time.

Verfügbar

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

Datenquellen und Integrationen

OpenWrt, externe Router und Switches im selben Panel.

Verfügbar

NetPulse empfängt Daten vom nativen Agenten, von externen Agenten für RouterOS, Asus, BBox und UniFi, von SNMP-Switches und vom RTLPlayground-Beacon. Jede Quelle nutzt den vom Gerät unterstützten Transport.

  • RouterOS, Asuswrt/Merlin, BBox und UniFi: schreibgeschützte Agenten mit signiertem HTTPS-Ingest.
  • Verwaltete Switches: SNMP für Ports, Geschwindigkeiten und LLDP-MIB-Nachbarn.
  • RTL8372/8373: Beacon-Firmware für Portstatus, Raten und FDB.
Datenquellen und Hardware ansehen

WLAN und Roaming

Who is stuck to which AP, and since when.

Verfügbar

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

Wi-Fi-Kanal-Analyse

The air, shown as it really is.

Verfügbar

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

Switch-Port-Detail

Every switch port, with its own history.

Verfügbar

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

WireGuard

Your tunnels, drawn from the internet to your phone.

Verfügbar

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
  • Verbindungs- und Trennungsereignisse im Aktivitätslog, mit Sitzungsdauer

AdGuard Home

What your network asks for, and what never gets in.

Verfügbar

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

Alarme

It notices things breaking before you do.

Verfügbar

Alarme nach Kategorie: Router, Internet, Clients, Signal, VPN und System, jeweils mit eigenem Dringlichkeitsgrad. Persistenter Feed mit automatischer Auflösung, nativer Web Push und pro-Gerät-Offline-Warnungen, die du im Client-Editor aktivierst.

  • Persistenter Feed mit automatischer Auflösung
  • Natives Web Push per VAPID, ohne Dritte
  • Handlungsvorschläge bei Port-Alarmen
  • Zusätzliche Kanäle: ntfy, Telegram und ausgehende Webhooks (nur dringende Alarme)

Berichte

Availability, daily, weekly and monthly.

Verfügbar

Verfügbarkeit pro Router und Gerät mit Stunden- und Tagesgranularität: durchschnittliche Latenz, akkumulierter Verkehr und CPU/RAM-Durchschnittswerte. CSV-Export eingebaut.

  • Verfügbarkeit pro Router und Gerät, stündlich und täglich
  • Durchschnittliche Latenz, RX/TX-Verkehr und CPU/RAM-Mittelwerte
  • CSV-Export direkt aus der Ansicht

Einstellungen

One place for all the configuration.

Verfügbar

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
  • Integrationen: MQTT/Home-Assistant-Publisher, MCP-Server, API-Tokens, HTTPS

Demo-Modus

Try everything without touching a real router.

Verfügbar

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

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

LuCI-App

The agent, living inside OpenWrt itself.

Verfügbar

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

On-Box-Modus

The server, running on the router itself.

Verfügbar

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

KI-Assistent (MCP)

Your AI assistant asks, NetPulse answers.

Verfügbar

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

Physisches Rack

Your 19-inch rack, with cabling proposed for you.

Verfügbar

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.

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

NetPulse und Home Assistant

Your routers, showing up as Home Assistant devices.

Verfügbar

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
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