Screenshots Aus der README von travisghansen/hass-opnsense.
Überblick
OPNsense ist eine Home Assistant Integration, die sich über das lokale Netzwerk mit einer OPNsense Firewall oder einem Router verbindet. Sie ersetzt die integrierte OPNsense Integration, die nur Geräte-Tracking bietet, und ergänzt Binärsensoren, Sensoren, Schalter, Update-Entitäten und Anwesenheitserkennung. Kategorien wie Telemetrie, Schnittstellen, DHCP-Leases, Gateways, Firmware, VPN, Dienste, CARP, vnStat-Bandbreite und Speedtest-Ergebnisse lassen sich gezielt synchronisieren, sodass der API-Benutzer engere Berechtigungen haben kann. Die Aktionen umfassen das Starten, Stoppen und Neustarten von Diensten, das Neustarten oder Anhalten des Routers, das Senden von Wake-on-LAN-Paketen, das Beenden von States, das Erzeugen von Captive-Portal-Vouchern, das Ausführen eines Speedtests und das Umschalten von Aliasen oder Schnittstellen. Ein separater CARP-VIP-Eintrag bietet nur lesenden Einblick in den aktiven Responder, während jeder physische Knoten für sich konfiguriert wird. Sie wird als benutzerdefiniertes Repository im Marketplace hinzugefügt und in der Home Assistant Oberfläche mit einem API-Schlüssel und einem Secret eingerichtet, und sie benötigt OPNsense Firmware 25.1 oder neuer.
Zusammenfassung der README und des Codes von travisghansen/hass-opnsense, 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
- Schalter
- Sensoren
- Anwesenheit
Einrichtung
Füge ihr Repository im Marketplace als benutzerdefiniertes Repository hinzu und installiere sie. Starte dann Home Assistant neu und füge sie unter Einstellungen > Geräte & Dienste hinzu.
Mit der OPNsense Firewall / dem Router verbinden
- URLVerwende die tatsächliche URL des OPNsense Geräts. Verwende keine virtuelle CARP-URL.
- API-Schlüssel
- API-Secret
- Firewall-Name
- SSL-Zertifikat prüfen
- Detaillierte Synchronisierungsoptionen aktivieren
Mit dem OPNsense CARP-VIP-Eintrag verbinden
- URLVerwende die virtuelle CARP-URL. Die einzelnen physischen Knoten müssen zusätzlich separat über ihre Verwaltungsadressen konfiguriert werden.
- API-Schlüssel
- API-Secret
- Anzeigename des CARP-VIP
- SSL-Zertifikat prüfen
Wähle, welche Elemente synchronisiert werden
- Grundlegende Telemetriedaten
- Schnittstelleninformationen
- Live-Datenverkehr der Schnittstellen
- DHCP-Leases
- Gateway-Informationen
- Firmware-Updates
- VPN-Informationen und Schalter
- CARP-Informationen
- Dienst-Schalter
- Hinweis-Informationen
- Schalter für Firewall- und NAT-Regeln
- Schalter für Unbound-Blocklisten
- Informationen zu Sicherheitszertifikaten
- vnStat-Bandbreitennutzung
- Speedtest-Ergebnisse
Verbindung zur OPNsense Firewall / zum Router aktualisieren
- Anzeigename
- URL
- API-Schlüssel
- API-Secret
- SSL-Zertifikat prüfen
Nach der Einrichtung
- AbfrageintervallDas Abfrageintervall legt fest, wie oft dieser Eintrag seine Quelle abfragt.
- Modus des Geräte-TrackersBei Track only selected devices kannst du in einem weiteren Schritt Geräte aus kürzlich erkannten ARP-Einträgen auswählen und MAC-Adressen manuell hinzufügen
- Abfrageintervall des Geräte-Trackers
- Geräte-Tracker: Als zu Hause betrachten
- Hostnamen des Geräte-Trackers auflösenWeist OPNsense an, ARP-Einträge rückwärts aufzulösen, damit Geräte-Tracker nach Hostnamen statt nach MAC-Adressen benannt werden. Deaktiviere dies, wenn der OPNsense Host keine funktionierende Reverse-DNS-Auflösung für LAN-Clients hat.
- Detaillierte Synchronisierungsoptionen aktivieren
- Grundlegende Telemetriedaten
- vnStat-Bandbreitennutzung
- Speedtest-Ergebnisse
- Live-Datenverkehr der Schnittstellen
- SMART-Festplatteninformationen
- NUT-USV-Status
- VPN-Informationen und Schalter
- Firmware-Updates
- CARP-Informationen
- DHCP-Leases
- Gateway-Informationen
- Dienst-Schalter
- Hinweis-Informationen
- Schalter für Firewall- und NAT-Regeln
- Schalter für Unbound-Blocklisten
- Zu verfolgende GeräteHier erscheinen nur kürzlich erkannte Geräte. Zuvor ausgewählte Geräte, die aktuell nicht erkannt werden, bleiben in der Liste verfügbar.
- Zusätzliche MAC-Adressen, die aktuell nicht erkannt werdenGib MAC-Adressen getrennt durch Kommas oder Zeilenumbrüche ein. Ungültige MAC-Adressen werden ignoriert. Beispiel: 00:00:00:00:00:00
Texte aus dem Code von travisghansen/hass-opnsense. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.
Entitäten
- SensorenAktiver Responder, CARP-VIP-Status
Aktionen
- Hinweis schließenSchließt einen oder alle Hinweise auf OPNsenseFelder: Hinweis-ID, OPNsense Gerät, OPNsense Entität
- Dienst startenStartet einen OPNsense DienstFelder: Dienst-ID, Dienstname, OPNsense Gerät, OPNsense Entität
- Dienst stoppenStoppt einen OPNsense DienstFelder: Dienst-ID, Dienstname, OPNsense Gerät, OPNsense Entität
- Dienst neu startenStartet einen OPNsense Dienst neuFelder: Dienst-ID, Dienstname, Nur wenn aktiv, OPNsense Gerät, OPNsense Entität
- System anhaltenHält den OPNsense Router anFelder: OPNsense Gerät, OPNsense Entität
- System neu startenStartet den OPNsense Router neuFelder: OPNsense Gerät, OPNsense Entität
- WOL sendenSendet ein Wake-on-LAN-Magic-PacketFelder: Schnittstellenname, MAC-Adresse, OPNsense Gerät, OPNsense Entität
- Schnittstelle neu ladenLädt eine OPNsense Schnittstelle neu oder startet sie neuFelder: Schnittstellenname, OPNsense Gerät, OPNsense Entität
- Captive-Portal-Gutscheine erzeugenGutscheine zur Verwendung mit dem Captive Portal (zum Beispiel WLAN für Gäste)Felder: Gültigkeit, Läuft ab in, Anzahl der Gutscheine, Gruppenname, Captive-Portal-Gutschein-Server, OPNsense Gerät, OPNsense Entität
- States beendenBeendet alle States für eine IP-AdresseFelder: IP-Adresse, OPNsense Gerät, OPNsense Entität
- Speedtest ausführenFührt einen OPNsense Speedtest aus und gibt die Ergebnisse als Antwortdaten der Aktion zurückFelder: OPNsense-Gerät, OPNsense-Entität
- vnStat-Metriken abrufenRuft geparste vnStat-Metriken für einen ausgewählten Zeitraum als Antwortdaten der Aktion abFelder: Zeitraum, OPNsense-Gerät, OPNsense-Entität
- Alias umschaltenEinen Alias umschalten, einschalten oder ausschaltenFelder: Alias-Name, Alias-Aktion, OPNsense-Gerät, OPNsense-Entität
- Schnittstelle umschaltenEine Schnittstelle umschalten, aktivieren oder deaktivieren. Erfordert OPNsense 26.7.6 oder neuer. Wendet die Schnittstellenkonfiguration an und kann die Verbindung zu Home Assistant trennen.Felder: Schnittstellen-Aktion, OPNsense-Gerät, OPNsense-Entität, Schnittstelle
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
- ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:OPNsense Firmware unter der Mindestversion, OPNsense Firmware unter der empfohlenen Version, Ersatzhardware erkannt
Aus der README
hass-opnsense uses aiopnsense as the backend client library to integrate OPNsense with Home Assistant.
A Discord server to discuss the integration is available. Click the Discord badge at the beginning of the page for the invite link.
Erscheint in Vulpo
Schnellumschalterkarte, Diagrammkarte, Apple Watch, Kontrollzentrum.Informationen
- Installationen
- 1.315 teilen Analysedaten
- GitHub-Sterne
- 470
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v1.3.0,
- Kategorie
- Computer und Netzwerk, Router und Netzwerk
- Art
- Marketplace-Integration
- Marke
- OPNsense
- Voraussetzung
- Wird im Marketplace als benutzerdefiniertes Repository hinzugefügt
- Domain
opnsense- Probleme
- Problem melden














