Geräte im heimischen Fritzbox-Netzwerk anzeigen

Ich muss regelmäßig prüfen, welche Geräte im Heimnetzwerk – und manchmal auch im Gastnetzwerk – online sind. Auch für mein Home Assistant-Setup ist es wichtig, schnell einen Überblick zu bekommen, welche Geräte erreichbar sind. Mit der Fritzbox-GUI geht das, aber bei vielen Geräten wird die Browser-Seite langsam und unübersichtlich. Also ein Grund, die Kommandozeile zu bemühen.

Der naheliegende erste Versuch war arp -a. Das gibt eine Liste aller Geräte im Netzwerk – dummerweise stimmen die Namen oft nicht. Der Grund: arp liefert nur IP- und MAC-Adressen, die Hostnamen kommen vom lokalen DNS-Server – also von der Fritzbox. Diese speichert Hostnamen als PTR-Records, aber nur wenn das Gerät bei der DHCP-Anmeldung seinen Namen mitsendet. Viele Geräte machen das nicht, oder ändern den Namen zwischendurch – die PTR-Records bleiben dann veraltet. Es kann durchaus passieren, dass ein iPhone als „Michels-Watch" angezeigt wird, weil die Adresse früher mal zu jenem anderen Gerät gehörte.

nmap -sn war der nächste Versuch. Ähnliches Problem: nmap nutzt ebenfalls DNS-Lookups für die Hostnamen – gleiche Quelle, gleiche Fehler, viele falsche Namen. 

Dann habe ich herausbekommen, dass die Fritzbox eine TR-064 SOAP-API hat, die direkt auf die internen „FriendlyNames“ zugreift – also die manuell in der Fritz-GUI festgelegten Namen. Diese werden nicht durch DNS überschrieben und bleiben auch nach Neustarts etc. stabil.

Die API liefert alle nötigen Daten, eine kleine Shell-Funktion ruft sie ab und formatiert die Ausgabe. 

Das Ergebnis ist eine zsh-Funktion netlist, die in einer Sekunde eine saubere Übersicht sortiert nach IP-Adressen gibt. Die letzte Spalte (Net) zeigt an, ob sich das Gerät im Gastnetzwerk befindet:

Optional (wie im folgenden Screenshot) mit den Flags -v, das den Gerätehersteller (Vendor) aus der nmap OUI-Datenbank heraussucht, und/oder -n, das nach Hostname sortiert. Der Vendor-Lookup nutzt die offizielle IEEE-Datenbank, die beim ersten Aufruf automatisch heruntergeladen wird

Und so geht’s:

Öffnen Sie ~/.zshrc in Ihrem Editor, z B. mit nano: nano ~/.zshrc. Fügen Sie am Ende der Datei die Credentials ein – diese müssen vor der netlist-Funktion stehen und angepasst werden:

export FRITZ_IP="192.168.X.X"
export FRITZ_USER="FRITZ_USER"
export FRITZ_PASS="IHR_PASSWORT"