UniFi Network Map für Home Assistant (Marketplace-Integration)

Installationen: 503 teilen Analysedaten
GitHub-Sterne: 38
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: v0.5.11, 26. Oktober 2026
Kategorie: Computer und Netzwerk, Router und Netzwerk
Art: Marketplace-Integration
Marke: Ubiquiti
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: unifi_network_map
Quelle: github.com/merlijntishauser/unifi-network-maps-ha
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Screenshots Aus der README von merlijntishauser/unifi-network-maps-ha.

Überblick

UniFi Network Map ist eine Integration, die eine interaktive Topologiekarte eines UniFi-Netzwerks zeichnet. Sie verbindet sich lokal mit einem UniFi-Controller, entweder mit Benutzername und Passwort oder mit einem API-Schlüssel auf Site-Ebene, und wird in der Benutzeroberfläche eingerichtet. Die Karte zeigt, wie Gateways, Switches, Access Points und Clients miteinander verbunden sind, mit optionalen Portbeschriftungen, Client-Filterung nach kabelgebunden oder drahtlos und der Wahl zwischen einem flachen und einem isometrischen Layout. Zu den Anzeigeoptionen gehören mehrere Farbthemen, zwei Symbolsätze sowie eine frei wählbare Breite und Höhe der Karte. Neben der Kartenansicht fügt sie Sensoren und Binärsensoren für Status, Clients und Geräteanwesenheit hinzu. Sie ist dafür gedacht, neben der integrierten UniFi-Integration zu laufen, wodurch ein Gerät auf der Karte mit seiner Home-Assistant-Entität verknüpft werden kann.

Zusammenfassung der README und des Codes von merlijntishauser/unifi-network-maps-ha, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

Sensoren

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

Mit UniFi verbinden

Controller-URLSchema angeben (http oder https) und Port falls nötig.
Benutzername
Passwort
API-SchlüsselSite-bezogener API-Schlüssel aus UniFi OS (Einstellungen -> Control Plane -> Integrationen). Verwende ihn anstelle von Benutzername und Passwort.
SiteDie interne Site-ID, normalerweise 'default'. Verwende bei einer Multi-Site-Installation den Site-Code aus der URL der Network-App (der Teil nach /manage/ oder /network/), nicht den Anzeigenamen der Site.
SSL überprüfen

Kartenoptionen

Port-Beschriftungen anzeigenFügt Switch-Port-Beschriftungen zu den Verbindungen hinzu.
Clients anzeigenFügt Client-Geräte zur Topologie hinzu.
Client-BereichWähle kabelgebundene, drahtlose oder alle Clients.
Nur UniFi-GeräteBlendet Nicht-UniFi-Geräte in der Topologie aus.
Isometrisches LayoutRendert eine 3D-ähnliche Ansicht.
SVG-Breite (px)Leer lassen für automatische Größe.
SVG-Höhe (px)Leer lassen für automatische Größe.
Anfrage-Timeout (Sekunden)UniFi-API-Aufrufe nach dieser Anzahl Sekunden abbrechen.
Gerenderte Karte cachenLetztes Rendering zwischen Abfragen wiederverwenden.

Erneut authentifizieren

Benutzername
Passwort
API-SchlüsselSite-bezogener API-Schlüssel aus UniFi OS (Einstellungen -> Control Plane -> Integrationen). Verwende ihn anstelle von Benutzername und Passwort.

Verbindung neu konfigurieren

Controller-URLSchema (http oder https) und Port angeben, falls erforderlich.
Benutzername
Passwort
API-SchlüsselSite-bezogener API-Schlüssel aus UniFi OS (Einstellungen -> Control Plane -> Integrationen). Verwende ihn anstelle von Benutzername und Passwort.
SiteDie interne Site-ID, normalerweise 'default'. Verwende bei einer Multi-Site-Installation den Site-Code aus der URL der Network-App (der Teil nach /manage/ oder /network/), nicht den Anzeigenamen der Site.
SSL verifizierenUniFi-Controller verwenden standardmäßig selbstsignierte Zertifikate, die die Verifizierung nicht bestehen. Nur aktivieren, wenn ein vertrauenswürdiges Zertifikat installiert ist.

Nach der Einrichtung

Aktualisierungsintervall (Minuten)Wie oft Daten vom UniFi-Controller abgerufen werden.
Port-Beschriftungen anzeigenFügt Switch-Port-Beschriftungen zu den Verbindungen hinzu.
Clients anzeigenFügt Client-Geräte zur Topologie hinzu.
Client-BereichWähle kabelgebundene, drahtlose oder alle Clients.
Nur UniFi-GeräteBlendet Nicht-UniFi-Geräte in der Topologie aus.
Isometrisches LayoutRendert eine 3D-ähnliche Ansicht.
KartenthemaFarbthema für die gerenderte Karte.
SymbolsatzSymbolstil für Geräteknoten.
Isometrische BeleuchtungSchattiert Seitenflächen und fügt Kontaktschatten hinzu (nur isometrisches Layout).
Verbindungen um Geräte herumführenFührt Verbindungen um dazwischenliegende Knoten herum (nur isometrisches Layout).
Bodenraster anzeigenZeichnet das isometrische Bodenraster hinter der Karte (nur isometrisches Layout).
SVG-Breite (px)Leer lassen für automatische Größe.
SVG-Höhe (px)Leer lassen für automatische Größe.
Anfrage-Timeout (Sekunden)UniFi-API-Aufrufe nach dieser Anzahl Sekunden abbrechen.
Payload-Cache-TTL (Sekunden)Angereicherte Payload-Daten für diese Anzahl Sekunden cachen. Auf 0 setzen zum Deaktivieren.

Texte aus dem Code von merlijntishauser/unifi-network-maps-ha.

Entitäten

SensorenStatus, Clients

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.

Aus der README

A Home Assistant integration that visualizes your UniFi network topology as an interactive map. See how your devices connect, which clients are online, and understand your network structure at a glance.

Aus der README von merlijntishauser/unifi-network-maps-ha, MIT License. Gekürzt.