Überblick
UniFi Insights verbindet Home Assistant über einen API-Schlüssel mit UniFi Network, Protect, Access und verwandten Ubiquiti-Produkten. Es funktioniert mit einer Konsole im lokalen Netzwerk oder mit jeder Konsole eines UniFi-Kontos über UniFi Cloud und wird in der Oberfläche eingerichtet. Es fügt Sensoren, Binärsensoren, Schalter, Tasten, Kameras, Schlösser, Lichter, Ereignisse, Geräte-Tracker und Firmware-Updates hinzu, gruppiert unter ihren UniFi-Geräten. Aktionen decken Aufgaben ab wie den Neustart von Geräten, den Power-Cycle von PoE-Ports, das erneute Verbinden von WLAN-Clients und den Export von Netzwerkregeln als Dokument. Mit den Optionen lassen sich WLAN- und kabelgebundene Clients verfolgen, die Abfragen auf ausgewählte Standorte beschränken und Türereignisse von Access empfangen. Sechs Dashboard-Karten werden mitinstalliert, und die Diagnose schwärzt API-Schlüssel, Adressen und Client-Namen.
Zusammenfassung der README und des Codes von tinkerologie/ha-unifi-insights, 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
- Lichter
- Abdeckungen
- Kameras
- Schlösser
- Alarmanlagen
- Medien
- Schalter
- Sensoren
- Anwesenheit
Einrichtung
Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.
Verbindungstyp
- VerbindungstypLokal: Verbinde dich direkt mit deinem UniFi-Gerät in deinem Netzwerk. Remote: Verbinde dich über UniFi Cloud mit deinem Cloud-API-Schlüssel.
Lokale Verbindung
- Host-URLDie URL deines UniFi-Geräts (zum Beispiel https://192.168.1.1)
- API-SchlüsselAPI-Schlüssel von deinem UniFi Controller (Settings → Control Plane → API Keys)
- SSL-Zertifikat überprüfenFür selbstsignierte Zertifikate deaktivieren (bei lokalen Geräten üblich)
- UniFi Access API-Token (optional)Erstelle ihn unter Access > Settings > General > Advanced. Er ist vom UniFi-API-Schlüssel getrennt und aktiviert Access-Türen, Notfallsteuerungen und Ereignisse. Leer lassen, um Access zu überspringen.
- Port der UniFi Access Developer-APIPort der UniFi Access Developer-API auf der Konsole. Der offizielle Standard ist 12445.
Remote-Verbindung (UniFi Cloud)
- API-SchlüsselCloud-API-Schlüssel aus deinem UniFi-Konto. Nach der Prüfung wählst du eine der Konsolen aus, auf die dieser API-Schlüssel zugreifen kann.
Remote-Konsole auswählen
- KonsoleDiese Konsolen wurden mit deinem API-Schlüssel gefunden.
UniFi Carrier Fabric
- API-SchlüsselEin API-Schlüssel mit Carrier Fabric ISP-Berechtigungen (Typ ISP).
Wird auch beim erneuten Anmelden abgefragt.
Erneut authentifizieren
- API-SchlüsselEin neuer API-Schlüssel von deinem UniFi Controller (Settings → Control Plane → API Keys)
Neu konfigurieren
- Host-URLDie URL deines UniFi-Geräts (zum Beispiel https://192.168.1.1)
- API-SchlüsselAPI-Schlüssel von deinem UniFi Controller (Settings → Control Plane → API Keys)
- SSL-Zertifikat überprüfenFür selbstsignierte Zertifikate deaktivieren (bei lokalen Geräten üblich)
- Konsolen-IDDie ID der UniFi-Cloud-Konsole, mit der sich dieser Eintrag verbindet
- UniFi Access API-Token (optional)Gib einen neuen Token ein, um den gespeicherten zu ersetzen. Leer lassen, um den aktuellen Token zu behalten.
- Port der UniFi Access Developer-APIPort der UniFi Access Developer-API auf der Konsole.
- Access-Token entfernenAktiviere dies, um den Access-Token und seinen Webhook für Zugangsergebnisse zu entfernen. Wird ignoriert, wenn ein neuer Token eingegeben wird.
Nach der Einrichtung
- WLAN-Clients verfolgenErstellt Geräte-Tracker-Entitäten für verbundene WLAN-Clients. Das kann viele Entitäten erzeugen.
- Kabelgebundene Clients verfolgenErstellt Geräte-Tracker-Entitäten für verbundene kabelgebundene (LAN-)Clients. Das kann viele Entitäten erzeugen.
- Client-Steuerung aktivierenErstellt Entitäten für Schalter zum Erlauben/Blockieren und Tasten zum erneuten Verbinden für verbundene Clients sowie Wake-on-LAN-Tasten (standardmäßig deaktiviert) für kabelgebundene Clients. Wenn du dies ausschaltest, werden die Client-Tasten entfernt.
- StandorteNur diese Standorte abfragen. Leer lassen, um jeden Standort der Konsole einzubeziehen. Nicht ausgewählte Standorte werden nicht abgefragt, was den API-Verkehr bei Konsolen mit mehreren Standorten verringert.
- Einzelne Abonnenten als Geräte verfolgenErstellt Geräteeinträge für jeden Abonnenten in deiner Carrier Fabric Organisation.
- Service-Aktionen aktivieren (Abonnenten sperren und fortsetzen)Erlaubt es, Abonnentendienste von Home Assistant aus zu sperren und fortzusetzen.
- Access-Türereignisse empfangen (gewährt und abgelehnt)Home Assistant muss für diese Ereignisse von der Konsole aus erreichbar sein. Ausschalten, um den Access-Webhook zu entfernen.
Texte aus dem Code von tinkerologie/ha-unifi-insights. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.
Entitäten
- AlarmanlagenAlarm
- TastenGeräteneustart, PoE-Power-Cycle, Gast-Voucher erzeugen, Entsperren, Erneut verbinden, Abspielen, PTZ-Patrouille starten, PTZ-Patrouille stoppen
- AbdeckungenTor
- AnwesenheitStandort
- EreignisseTürklingel, Smarte Erkennung, Tür/Fenster, Änderungen der Netzwerkregeln, Zugangsergebnis
- BilderGrundriss, QR-Code des neuesten Vouchers, WLAN-QR-Code
- SchlösserSchloss
- MedienLautsprecher
- ZahlenMikrofonlautstärke, Helligkeitsstufe, Gong-Lautstärke, Wiederholungen, Voucher-Dauer, Voucher-Gästelimit, Voucher-Downloadlimit, Voucher-Uploadlimit, Voucher-Datenlimit
- AuswahlfelderHDR-Modus, Videomodus, Klingelton, PTZ-Voreinstellung, Liveview
- SensorenCPU-Auslastung, Speicherauslastung, Betriebszeit, Uplink-Senderate, Uplink-Empfangsrate, Temperatur, Luftfeuchtigkeit, Batterie und 72 weitere
- SchalterStatuslicht, Hochfrequenzmodus (High FPS), Erlauben, Aus- und Wiedereinschalten, VPN-Client, Sperrung, Evakuierung
- UpdatesFirmware
Aktionen
- Daten aktualisierenErzwingt eine sofortige Aktualisierung der UniFi-Insights-Daten.Felder: Site-ID
- Gerät neu startenStartet ein UniFi-Gerät neu.Felder: Site-ID, Geräte-ID, Entität
- Gekoppelte Türklingeln des Gongs festlegenWähle aus, welche Türklingeln einen UniFi-Protect-Gong auslösen. Die Auswahl ersetzt die aktuelle Kopplung des Gongs. Lass Türklingeln leer, um alle Türklingeln zu entkoppeln.Felder: Gong-ID, Türklingeln, Entität, Gerät
- Teilnehmer sperrenBeendet den Internetdienst eines Teilnehmers. Setzt voraus, dass die Option "Enable service actions" im Carrier-Fabric-Integrationseintrag aktiviert ist und ein ISP-API-Schlüssel mit dem Scope suspend:service vorhanden ist.Felder: Grund, Entität, Gerät
- Teilnehmer wieder freischaltenStellt den Internetdienst eines Teilnehmers wieder her. Setzt voraus, dass die Option "Enable service actions" im Carrier-Fabric-Integrationseintrag aktiviert ist und ein ISP-API-Schlüssel mit dem Scope resume:service vorhanden ist.Felder: Entität, Gerät
- PoE-Port aus- und wieder einschaltenSchaltet einen PoE-fähigen Port an einem UniFi-Netzwerkgerät aus und wieder ein.Felder: Site-ID, Geräte-ID, Portindex, Entität
- Client neu verbindenVerbindet einen verbundenen WLAN-Client erneut mit dem WLAN. Akzeptiert nur Clients, die aktuell verbunden und drahtlos sind.Felder: Site-ID, Client-ID, Entität, Gerät
- Clients entfernenEntfernt kurzlebige, unbenannte historische Clients aus dem UniFi Network. Vergisst Clients ohne Namen, Hostnamen oder feste IP, die höchstens 15 Minuten gesehen wurden. Fehlt ein Zeitstempel, wird der Client von der Altersprüfung nicht ausgeschlossen. Verarbeitet die in den Einstellungen der Integration gewählten Sites auf Konsolen, auf denen Network verfügbar ist. Clients mit einem Zeitstempel, der keine Zahl ist, bleiben erhalten. Erfordert einen Administrator. Entfernt keine Home-Assistant-Geräte oder -Entitäten.
- Gong-Klingelton abspielenDiese Aktion löst immer einen Fehler wegen fehlender Unterstützung aus, weil die offizielle Protect-API keine Wiedergabe für Gongs bietet.Felder: Gong-ID, Klingelton-ID, Entität, Gerät
- Netzwerkregeln exportierenGibt einen Snapshot der Firewall-Richtlinien, richtlinienbasierten Routen, Portweiterleitungen, Traffic-Regeln, NAT-Regeln und statischen Routen einer Konsole als versioniertes Dokument zurück, für Vergleich, Versionierung und manuelle Wiederherstellung. Es ist kein vollständiges Backup der Konsole: Die Netzwerke, Zonen, Traffic-Matching-Listen, Gruppen und VPN-Definitionen, auf die sich Regeln beziehen, sind nicht enthalten, und es gibt keinen Import. Die Regeln werden beim Ausführen der Aktion von der Konsole gelesen. Nur ein Regeltyp mit dem Status ok ist vollständig. Failed bedeutet, dass die Antwort nicht gelesen werden konnte, kein JSON war, unvollständig war oder einen Datensatz enthielt, der nicht verarbeitet werden konnte. Unsupported bedeutet, dass die Konsole die Anfrage abgelehnt hat oder dass die Site für die fünf anderen Regeltypen als Firewall-Richtlinien keinen klassischen Namen hat. Erfordert einen Admin-Benutzer. Die Aktion gibt nur Daten zurück; sie schreibt keine Datei.Felder: Site-ID, Konsole, Regeltypen, Sensible Werte schwärzen
- Access-Benutzer-PIN festlegenWeist einem UniFi Access-Benutzer eine PIN zu. Die PIN darf nur aus Ziffern bestehen; die Konsole prüft die Länge und lehnt den Wert ab, wenn sie ihn nicht akzeptiert. Erfordert einen Admin-Benutzer.Felder: Benutzer-ID, PIN, Konsole
- Access-Benutzer-PIN entfernenEntfernt die PIN, die einem UniFi Access-Benutzer zugewiesen ist. Erfordert einen Admin-Benutzer.Felder: Benutzer-ID, Konsole
- Access-Benutzerstatus festlegenSetzt ein UniFi Access-Benutzerkonto auf ACTIVE oder DEACTIVATED. Das steuert das gesamte Konto, sodass ein deaktivierter Benutzer den Zugang über jede Zugangsberechtigung verliert. Erfordert einen Admin-Benutzer.Felder: Benutzer-ID, Status, Konsole
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
Aus der README
Monitor and control your UniFi system from Home Assistant: UniFi Network, UniFi Protect, UniFi Access, UniFi InnerSpace, UniFi Mobility, UniFi Site Manager and UniFi Carrier Fabric, in one integration.
Erscheint in Vulpo
Lichtkarte, Schnellumschalterkarte, Rollladenkarte, Schlosskarte, Apple Watch, Kontrollzentrum.Informationen
- Installationen
- 413 teilen Analysedaten
- GitHub-Sterne
- 47
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v2026.10.4,
- Kategorie
- Computer und Netzwerk, Router und Netzwerk
- Art
- Marketplace-Integration
- Marke
- Ubiquiti
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
unifi_insights- Probleme
- Problem melden
















