OPNsense pour Home Assistant (intégration de la Marketplace)

Installations: 1,3 k partagent leurs statistiques
Étoiles GitHub: 470
Connexion: Fonctionne en local
Maintenance: Mise à jour au cours des 6 derniers mois
Version: v1.3.0, 24 octobre 2026
Catégorie: Informatique et réseau, Routeurs et réseau
Type: Intégration de la Marketplace
Marque: OPNsense
Prérequis: Ajout comme dépôt personnalisé dans la Marketplace
Domaine: opnsense
Source: github.com/travisghansen/hass-opnsense
Problèmes: Signaler un problème

Annuaire indépendant, créé par le développeur de Vulpo. Non affilié à Home Assistant ni à l’Open Home Foundation.

Captures d’écran Extraites du README de travisghansen/hass-opnsense.

À propos

OPNsense est une intégration Home Assistant qui se connecte à un pare-feu ou un routeur OPNsense via le réseau local. Elle remplace l'intégration OPNsense native, qui ne propose que le suivi d'appareil, et ajoute des capteurs binaires, des capteurs, des interrupteurs, des entités de mise à jour et le suivi de présence. Des catégories comme la télémétrie, les interfaces, les baux DHCP, les passerelles, le firmware, le VPN, les services, CARP, la bande passante vnStat et les résultats de speedtest peuvent être synchronisées de façon sélective, ce qui permet à l'utilisateur de l'API d'avoir des permissions plus restreintes. Les actions permettent de démarrer, d'arrêter et de redémarrer des services, de redémarrer ou d'arrêter le routeur, d'envoyer des paquets wake-on-lan, de supprimer des états, de générer des bons de portail captif, de lancer un speedtest et de basculer des alias ou des interfaces. Une entrée distincte pour l'IP virtuelle CARP donne une visibilité en lecture seule sur le répondeur actif, tandis que chaque nœud physique est configuré séparément. Elle s'ajoute comme dépôt personnalisé dans le Marketplace et se configure dans l'interface de Home Assistant avec une clé d'API et un secret, et elle nécessite le firmware OPNsense 25.1 ou plus récent.

Résumé automatique du README et du code de travisghansen/hass-opnsense, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact

Prise en charge

Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.

Fournit

Interrupteurs
Capteurs
Présence

Mise en place

Ajoute son dépôt à la Marketplace comme dépôt personnalisé et installe-la, puis redémarre Home Assistant et ajoute-la dans Paramètres > Appareils et services.

Connectez-vous au pare-feu/routeur OPNsense

URLUtilisez l’URL réelle de l’appareil OPNsense.
Clé API
Secret API
Nom du pare-feu
Vérifier le certificat SSL
Activer les options de synchronisation granulaire

Connectez-vous à l'entrée VIP OPNsense CARP

URLUtilisez l'URL virtuelle CARP ;
Clé API
Secret API
Nom d'affichage VIP CARP
Vérifier le certificat SSL

Choisissez les éléments à synchroniser

Données télémétriques de base
Informations sur les interfaces
Trafic de l'interface en direct
Baux DHCP
Informations sur la passerelle
Mises à jour du micrologiciel
Informations VPN et commutateurs
Informations CARP
Commutateurs de service
Informations sur les avis
Commutateurs de règles de pare-feu et NAT
Commutateurs de liste de blocage non liés
Informations sur le certificat de sécurité
Utilisation de la bande passante vnStat
Résultats des tests de vitesse

Mettre à jour la connexion au pare-feu/routeur OPNsense

Nom d'affichage
URL
Clé API
Secret API
Vérifier le certificat SSL

Après la mise en place

Intervalle de numérisationL'intervalle d'analyse contrôle la fréquence à laquelle cette entrée interroge sa source.
Mode de suivi des appareilsPour « Suivre uniquement les appareils sélectionnés », une étape suivante vous permet de sélectionner les appareils parmi les détections ARP récentes et d'ajouter manuellement des adresses MAC.
Intervalle d'analyse du suivi des appareils
Dispositif de suivi des appareils Considérez la maison
Résoudre les noms d'hôte du suivi d'appareilsDemande à OPNsense de résoudre en sens inverse les entrées ARP afin que les suivis d'appareil portent le nom d'hôte plutôt que l'adresse MAC. Désactive cette option si l'hôte OPNsense n'a pas de DNS inverse fonctionnel pour les clients du LAN.
Activer les options de synchronisation granulaire
Données télémétriques de base
Utilisation de la bande passante vnStat
Résultats des tests de vitesse
Trafic de l'interface en direct
Informations sur le disque SMART
Statut NUT-UPS
Informations VPN et commutateurs
Mises à jour du micrologiciel
Informations CARP
Baux DHCP
Informations sur la passerelle
Commutateurs de service
Informations sur les avis
Commutateurs de règles de pare-feu et NAT
Commutateurs de liste de blocage non liés
Appareils à suivreSeuls les appareils récemment détectés apparaissent ici.
Adresses MAC supplémentaires non détectées actuellementEntrez les adresses MAC séparées par des virgules ou des nouvelles lignes.

Textes issus du code de travisghansen/hass-opnsense. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.

Entités

CapteursRépondeur actif, Statut VIP CARP

Actions

Fermer l'avisFerme une ou toutes les notifications sur OPNsenseChamps : ID de l'avis, Appareil OPNsense, Entité OPNsense
Démarrer le serviceDémarre un service OPNsenseChamps : Numéro de service, Nom du service, Appareil OPNsense, Entité OPNsense
Arrêter le serviceArrête un service OPNsenseChamps : Numéro de service, Nom du service, Appareil OPNsense, Entité OPNsense
Redémarrer le serviceRedémarre un service OPNsenseChamps : Numéro de service, Nom du service, Seulement si vous courez, Appareil OPNsense, Entité OPNsense
Système d'arrêtArrête le routeur OPNsenseChamps : Appareil OPNsense, Entité OPNsense
Redémarrer le systèmeRedémarre le routeur OPNsenseChamps : Appareil OPNsense, Entité OPNsense
Envoyer WOLEnvoie un paquet magique de réveil sur réseau localChamps : Nom de l'interface, Adresse MAC, Appareil OPNsense, Entité OPNsense
Recharger une interfaceRecharger ou redémarrer une interface OPNsenseChamps : Nom de l'interface, Appareil OPNsense, Entité OPNsense
Générer des bons de portail captifBons à utiliser avec Captive Portal (comme le WiFi invité)Champs : Validité, Expire dans, Nombre de bons, Nom du groupe, Serveur de bons de portail captif, Appareil OPNsense, Entité OPNsense
Tuer les ÉtatsTuez tous les états pour une adresse IPChamps : Adresse IP, Appareil OPNsense, Entité OPNsense
Exécuter un test de vitesseExécutez un test de vitesse OPNsense et renvoyez les résultats sous forme de données de réponse à l'actionChamps : Appareil OPNsense, Entité OPNsense
Obtenir les métriques vnStatObtenez les métriques vnStat analysées pour une période sélectionnée en tant que données de réponse à l'actionChamps : Période, Appareil OPNsense, Entité OPNsense
Basculer l'aliasActiver, activer ou désactiver un aliasChamps : Nom d'alias, Action d'alias, Appareil OPNsense, Entité OPNsense
Basculer une interfaceActiver, désactiver ou basculer une interface. Nécessite OPNsense 26.7.6 ou une version ultérieure. Applique la configuration des interfaces et peut déconnecter Home Assistant.Champs : Action sur l’interface, Appareil OPNsense, Entité OPNsense, Interface

Dépannage

DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Micrologiciel OPNsense inférieur à la version minimale, Micrologiciel OPNsense inférieur à la version recommandée, Matériel de remplacement détecté

Extrait du 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.

Extrait du README de travisghansen/hass-opnsense, Apache License 2.0. Abrégé.