OPNsense voor Home Assistant (Marketplace-integratie)

Installaties: 1,3K die analysegegevens delen
GitHub-sterren: 470
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v1.3.0, 24 oktober 2026
Categorie: Computers en netwerk, Routers en netwerk
Soort: Marketplace-integratie
Merk: OPNsense
Vereist: Toegevoegd als aangepaste repository in de Marketplace
Domein: opnsense
Bron: github.com/travisghansen/hass-opnsense
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Screenshots Uit de README van travisghansen/hass-opnsense.

Over dit item

OPNsense is een Home Assistant-integratie die via het lokale netwerk verbinding maakt met een OPNsense-firewall of -router. Het vervangt de ingebouwde OPNsense-integratie, die alleen apparaattracking biedt, en voegt binaire sensoren, sensoren, schakelaars, update-entiteiten en aanwezigheidsdetectie toe. Categorieën zoals telemetrie, interfaces, DHCP-leases, gateways, firmware, VPN, services, CARP, vnStat-bandbreedte en speedtestresultaten kunnen selectief worden gesynchroniseerd, zodat de API-gebruiker beperktere rechten kan hebben. Acties omvatten het starten, stoppen en herstarten van services, het herstarten of stoppen van de router, het verzenden van wake-on-lan-pakketten, het beëindigen van states, het genereren van captive portal-vouchers, het uitvoeren van een speedtest en het in- of uitschakelen van aliassen of interfaces. Een aparte CARP virtual IP-invoer geeft alleen-lezen inzicht in de actieve responder, terwijl elk fysiek knooppunt afzonderlijk wordt geconfigureerd. Het wordt toegevoegd als aangepaste repository in de Marketplace en ingesteld in de Home Assistant-gebruikersinterface met een API-sleutel en geheim, en vereist OPNsense-firmware 25.1 of nieuwer.

Automatische samenvatting van de README en de code van travisghansen/hass-opnsense, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Schakelaars
Sensoren
Aanwezigheid

Instellen

Voeg de repository als aangepaste repository toe aan de Marketplace en installeer de integratie. Herstart daarna Home Assistant en voeg de integratie toe onder Instellingen > Apparaten en diensten.

Verbinden met de OPNsense-firewall / -router

URLGebruik de daadwerkelijke URL van het OPNsense-apparaat. Gebruik geen virtuele CARP-URL.
API-sleutel
API-geheim
Firewallnaam
SSL-certificaat verifiëren
Gedetailleerde synchronisatieopties inschakelen

Verbinden met de OPNsense CARP VIP-invoer

URLGebruik de virtuele CARP-URL; afzonderlijke fysieke knooppunten moeten ook apart worden geconfigureerd via hun beheeradressen.
API-sleutel
API-geheim
Weergavenaam van CARP VIP
SSL-certificaat verifiëren

Kies welke items worden gesynchroniseerd

Basistelemetriegegevens
Interfaceinformatie
Live interfaceverkeer
DHCP-leases
Gatewayinformatie
Firmware-updates
VPN-informatie en schakelaars
CARP-informatie
Serviceschakelaars
Meldingsinformatie
Schakelaars voor firewall- en NAT-regels
Schakelaars voor Unbound-blokkeerlijsten
Informatie over beveiligingscertificaten
vnStat-bandbreedtegebruik
Speedtestresultaten

Verbinding met de OPNsense-firewall / -router bijwerken

Weergavenaam
URL
API-sleutel
API-geheim
SSL-certificaat verifiëren

Na het instellen

ScanintervalHet scaninterval bepaalt hoe vaak deze invoer zijn bron raadpleegt.
Modus van apparaattrackerBij Alleen geselecteerde apparaten volgen kun je in een volgende stap apparaten kiezen uit recente ARP-detecties en MAC-adressen handmatig toevoegen
Scaninterval van apparaattracker
Apparaattracker: als thuis beschouwen
Hostnamen van apparaattracker omzettenVraag OPNsense om ARP-invoeren omgekeerd om te zetten, zodat apparaattrackers een hostnaam krijgen in plaats van een MAC-adres. Schakel uit als de OPNsense-host geen werkende reverse DNS heeft voor LAN-clients.
Gedetailleerde synchronisatieopties inschakelen
Basistelemetriegegevens
vnStat-bandbreedtegebruik
Speedtestresultaten
Live interfaceverkeer
SMART-schijfinformatie
NUT UPS-status
VPN-informatie en schakelaars
Firmware-updates
CARP-informatie
DHCP-leases
Gatewayinformatie
Serviceschakelaars
Meldingsinformatie
Schakelaars voor firewall- en NAT-regels
Schakelaars voor Unbound-blokkeerlijsten
Te volgen apparatenAlleen recent gedetecteerde apparaten verschijnen hier. Eerder geselecteerde apparaten die nu niet worden gedetecteerd, blijven beschikbaar in de lijst.
Extra MAC-adressen die nu niet worden gedetecteerdVoer MAC-adressen in, gescheiden door komma's of nieuwe regels. Ongeldige MAC-adressen worden genegeerd. Voorbeeld: 00:00:00:00:00:00

Teksten uit de code van travisghansen/hass-opnsense. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

SensorenActieve responder, CARP VIP-status

Acties

Melding sluitenSluit één of alle meldingen op OPNsenseVelden: Meldings-ID, OPNsense-apparaat, OPNsense-entiteit
Service startenStart een OPNsense-serviceVelden: Service-ID, Servicenaam, OPNsense-apparaat, OPNsense-entiteit
Service stoppenStopt een OPNsense-serviceVelden: Service-ID, Servicenaam, OPNsense-apparaat, OPNsense-entiteit
Service herstartenHerstart een OPNsense-serviceVelden: Service-ID, Servicenaam, Alleen als actief, OPNsense-apparaat, OPNsense-entiteit
Systeem stoppenStopt de OPNsense RouterVelden: OPNsense-apparaat, OPNsense-entiteit
Systeem herstartenHerstart de OPNsense RouterVelden: OPNsense-apparaat, OPNsense-entiteit
WOL verzendenVerzendt een wake-on-lan magic packetVelden: Interfacenaam, MAC-adres, OPNsense-apparaat, OPNsense-entiteit
Interface opnieuw ladenLaadt een OPNsense-interface opnieuw of herstart dezeVelden: Interfacenaam, OPNsense-apparaat, OPNsense-entiteit
Captive Portal-vouchers genererenVouchers voor gebruik met Captive Portal (zoals gast-wifi)Velden: Geldigheid, Verloopt over, Aantal vouchers, Groepsnaam, Captive Portal-voucherserver, OPNsense-apparaat, OPNsense-entiteit
States beëindigenBeëindig alle states voor een IP-adresVelden: IP-adres, OPNsense-apparaat, OPNsense-entiteit
Speedtest uitvoerenVoer een OPNsense-speedtest uit en geef de resultaten terug als antwoordgegevens van de actieVelden: OPNsense-apparaat, OPNsense-entiteit
vnStat-metrics ophalenHaal verwerkte vnStat-metrics voor een gekozen periode op als antwoordgegevens van de actieVelden: Periode, OPNsense-apparaat, OPNsense-entiteit
Alias wisselenEen alias wisselen, inschakelen of uitschakelenVelden: Aliasnaam, Aliasactie, OPNsense-apparaat, OPNsense-entiteit
Interface wisselenEen interface wisselen, inschakelen of uitschakelen. Vereist OPNsense 26.7.6 of nieuwer. Past de interfaceconfiguratie toe en kan de verbinding met Home Assistant verbreken.Velden: Interfaceactie, OPNsense-apparaat, OPNsense-entiteit, Interface

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:OPNsense-firmware onder de minimumversie, OPNsense-firmware onder de aanbevolen versie, Vervangende hardware gedetecteerd

Uit de 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.

Uit de README van travisghansen/hass-opnsense, Apache License 2.0. Ingekort.