Captures d’écran Extraites du README de Csontikka/ha-mikrotik-extended.
À propos
MikroTik Extended est une intégration qui permet de gérer depuis Home Assistant des routeurs MikroTik sous RouterOS 7 ou plus récent. Elle communique avec le routeur en local et couvre des relevés système comme les températures, la tension, la consommation électrique et l’état de l’onduleur, ainsi qu’un bouton de redémarrage pour chaque routeur. La surveillance des interfaces comprend l’état de la liaison, des interrupteurs de port, les débits de trafic et le contrôle de la sortie PoE, avec un bouton de cycle d’alimentation par port. Chaque règle NAT, Mangle, Filter, Raw et Routing peut avoir son interrupteur, et des suivis d’appareil suivent les appareils connectés. Des capteurs optionnels couvrent les modems LTE et 5G, les conteneurs, les entrées Netwatch et les profils Kid Control, avec des préréglages qui limitent les entités créées. Plusieurs routeurs peuvent être utilisés en même temps, et la configuration se fait dans l’interface, soit en analysant le réseau, soit en saisissant les informations de l’hôte.
Résumé automatique du README et du code de Csontikka/ha-mikrotik-extended, 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
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Configurer MikroTik Extended
- Nom de l'intégration
- Hôte
- PortPort de l'API RouterOS. Laisser à 0 pour utiliser le port par défaut : 8728 (sans SSL) ou 8729 (SSL).
- Identifiant
- Mot de passe
- Sécurité de connexion
Ajouter un routeur MikroTik
- Rechercher les routeurs MikroTik sur le réseau
Configuration MikroTik Extended (2/4)
- Intervalle d'analyse (secondes)Minimum : 10s. Défaut : 30s. Des valeurs plus basses augmentent la charge sur l'API RouterOS.
- Intervalle de suivi des appareils (secondes)Fréquence à laquelle les appareils suivis sont pingués et leur état actualisé. Minimum : 5s. Maximum : 300s. Par défaut : 10s. Augmentez-la sur les grands réseaux pour réduire la charge. Jamais plus de la moitié du délai d'expiration du suivi. Les changements présent/absent peuvent être retardés d'un intervalle au maximum.
- Délai d'expiration du suivi des appareils réseau (secondes)Appareils filaires uniquement. Secondes avant qu'un appareil soit considéré hors ligne s'il n'est plus visible dans ARP. Défaut : 180s.
- Zone pour le traceur d'appareilNom de la zone Home Assistant à utiliser lorsqu'un appareil suivi est connecté. Défaut : home.
Routeurs MikroTik trouvés
- Sélectionner un routeur
Configuration MikroTik Extended (3/4)
- Préréglage capteursRecommandé active les capteurs les plus utiles avec un nombre minimal d'entités. Complet active tout — à utiliser avec précaution sur les grands réseaux.
Configuration MikroTik Extended (4/4)
- Données du portail captifAjoute le statut d'autorisation hotspot aux appareils suivis. Utile uniquement si un portail captif (hotspot) est configuré.
- Capteurs de trafic de clients2 capteurs par appareil suivi (vitesse TX/RX). Nécessite RouterOS 7 avec Kid Control — l'intégration crée automatiquement un profil 'ha-monitoring' sur le routeur lors de l'activation. Les capteurs n'apparaissent que pour les appareils activement suivis par Kid Control. Remarque : RouterOS 6 n'est pas pris en charge.
- Capteurs de conteneursCapteur et interrupteur par conteneur pour surveiller et démarrer/arrêter des conteneurs de type Docker.
- Capteurs de variables d'environnementCapteurs pour les variables d'environnement RouterOS.
- Interrupteurs de filtrageInterrupteur par règle de filtre pour activer/désactiver les règles de filtre pare-feu depuis HA. Attention : crée une entité par règle de filtre.
- Interface entitiesCrée des entités pour les interfaces réseau (interrupteurs de port, suivis de port, capteurs de trafic, adresses IP). Désactive cette option pour ne surveiller que l’appareil principal, ce qui évite aussi les requêtes de liaison par port. Les suivis de port et les capteurs de trafic des ports ne sont créés que si cette option est activée. Attention : la désactivation supprime ces entités et leurs appareils par port, donc un port renommé ou une zone attribuée ne sera pas restauré quand tu réactiveras l’option.
- Contrôle parentalInterrupteurs pour les profils d'appareils Kid Control (pause/reprise de l'accès Internet).
- Capteurs du modem LTE / 5GCapteurs par modem LTE ou 5G : opérateur, technologie d'accès, niveaux de signal (RSSI, RSRP, RSRQ, SINR, CQI) et bandes. Une requête supplémentaire par modem à chaque cycle ; aucun routeur sans modem n'est interrogé.
- Interrupteurs MangleInterrupteur par règle Mangle pour activer/désactiver les règles de marquage de paquets depuis HA. Attention : crée une entité par règle Mangle.
- Interrupteurs NATInterrupteur par règle NAT pour activer/désactiver les règles depuis HA. Attention : crée une entité par règle NAT.
- Capteurs NetwatchCapteur binaire par entrée Netwatch indiquant le statut d'accessibilité.
- Compteurs d'erreurs des ports4 capteurs par interface (erreurs RX/TX et paquets rejetés RX/TX) pour repérer un câble défectueux ou un port défaillant. Attention : crée 4 entités par interface.
- Interrupteurs de portInterrupteur par port pour l'activer/le désactiver depuis HA. Désactivez cette option pour éviter de couper un port par erreur ; les autres entités du port restent.
- Capteurs d'état des interfacesCapteur binaire par port indiquant l'état du lien (actif/inactif).
- Capteurs de trafic par interface4 capteurs par interface (octets TX/RX et totaux). Attention : crée 4 entités par interface — désactiver si les graphiques de trafic ne sont pas nécessaires.
Réauthentifier MikroTik Extended
- Identifiant
- Mot de passe
Reconfigurer MikroTik Extended
- Nom de l'intégration
- Hôte
- PortPort de l'API RouterOS. Laisser à 0 pour utiliser le port par défaut : 8728 (sans SSL) ou 8729 (SSL).
- Identifiant
- Mot de passeLaissez vide pour conserver le mot de passe enregistré.
- Sécurité de connexion
Après la mise en place
- Intervalle d'analyseMinimum : 10s. Défaut : 30s. Des valeurs plus basses augmentent la charge sur l'API RouterOS.
- Afficher l'IP et le MAC du client sur les interfaces
- Unité de mesure
- Intervalle de suivi des appareils (secondes)Fréquence à laquelle les appareils suivis sont pingués et leur état actualisé. Minimum : 5s. Maximum : 300s. Par défaut : 10s. Augmentez-la sur les grands réseaux pour réduire la charge. Jamais plus de la moitié du délai d'expiration du suivi. Les changements présent/absent peuvent être retardés d'un intervalle au maximum.
- Délai d'expiration du suivi des appareils réseau (secondes)Appareils filaires uniquement. Secondes avant qu'un appareil soit considéré hors ligne s'il n'est plus visible dans ARP. Défaut : 180s.
- Zone pour le traceur d'appareilNom de la zone Home Assistant à utiliser lorsqu'un appareil suivi est connecté. Défaut : home.
- Préréglage capteursSélectionnez un préréglage pour configurer rapidement les capteurs et interrupteurs activés, ou choisissez Personnalisé pour configurer individuellement.
- Données du portail captifAjoute le statut d'autorisation hotspot aux appareils suivis. Utile uniquement si un portail captif (hotspot) est configuré.
- Capteurs de trafic de clients2 capteurs par appareil suivi (vitesse TX/RX). Nécessite RouterOS 7 avec Kid Control — l'intégration crée automatiquement un profil 'ha-monitoring' sur le routeur lors de l'activation. Les capteurs n'apparaissent que pour les appareils activement suivis par Kid Control. Remarque : RouterOS 6 n'est pas pris en charge.
- Capteurs de conteneursCapteur et interrupteur par conteneur pour surveiller et démarrer/arrêter des conteneurs de type Docker.
- Capteurs de variables d'environnementCapteurs pour les variables d'environnement RouterOS.
- Interrupteurs de filtrageInterrupteur par règle de filtre pour activer/désactiver les règles de filtre pare-feu depuis HA. Attention : crée une entité par règle de filtre.
- Interface entitiesCrée des entités pour les interfaces réseau (interrupteurs de port, suivis de port, capteurs de trafic, adresses IP). Désactive cette option pour ne surveiller que l’appareil principal, ce qui évite aussi les requêtes de liaison par port. Les suivis de port et les capteurs de trafic des ports ne sont créés que si cette option est activée. Attention : la désactivation supprime ces entités et leurs appareils par port, donc un port renommé ou une zone attribuée ne sera pas restauré quand tu réactiveras l’option.
- Contrôle parentalInterrupteurs pour les profils d'appareils Kid Control (pause/reprise de l'accès Internet).
- Capteurs du modem LTE / 5GCapteurs par modem LTE ou 5G : opérateur, technologie d'accès, niveaux de signal (RSSI, RSRP, RSRQ, SINR, CQI) et bandes. Une requête supplémentaire par modem à chaque cycle ; aucun routeur sans modem n'est interrogé.
- Interrupteurs MangleInterrupteur par règle Mangle pour activer/désactiver les règles de marquage de paquets depuis HA. Attention : crée une entité par règle Mangle.
- Interrupteurs NATInterrupteur par règle NAT pour activer/désactiver les règles depuis HA. Attention : crée une entité par règle NAT.
- Capteurs NetwatchCapteur binaire par entrée Netwatch indiquant le statut d'accessibilité.
- Compteurs d'erreurs des ports4 capteurs par interface (erreurs RX/TX et paquets rejetés RX/TX) pour repérer un câble défectueux ou un port défaillant. Attention : crée 4 entités par interface.
- Interrupteurs de portInterrupteur par port pour l'activer/le désactiver depuis HA. Désactivez cette option pour éviter de couper un port par erreur ; les autres entités du port restent.
- Capteurs d'état des interfacesCapteur binaire par port indiquant l'état du lien (actif/inactif).
- Capteurs de trafic par interface4 capteurs par interface (octets TX/RX et totaux). Attention : crée 4 entités par interface — désactiver si les graphiques de trafic ne sont pas nécessaires.
Textes issus du code de Csontikka/ha-mikrotik-extended. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesOnduleur, PPP, Connexion, Netwatch, Connecté
- BoutonsConfiguration backup, Cycle d'alimentation PoE, Redémarrer
- SélecteursPoE out
- CapteursTempérature, Tension, Température CPU, Température SFP, Température du switch, Température de la carte, Température PHY, Consommation électrique, Consommation PoE sortie, Puissance PoE sortie, Tension PoE sortie, Courant PoE sortie et 28 autres
- InterrupteursPort, PPP secret, En pause
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Extrait du README
Note: For best viewing experience, read this documentation on GitHub.
Full-featured Home Assistant integration for MikroTik routers running RouterOS 7+. Monitor system resources, control firewall rules, track network devices, manage WireGuard peers, containers, and more — all from your HA dashboard. Supports multiple routers simultaneously.
- NAT rules
- Mangle rules
- Filter rules
- Raw rules
- Routing rules
S’affiche dans Vulpo :
carte Bascule rapide, carte Bouton, carte Sélection, carte Graphique, Apple Watch, centre de contrôle.Informations
- Installations
- 205 partagent leurs statistiques
- Étoiles GitHub
- 38
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v0.14.0,
- Catégorie
- Informatique et réseau, Routeurs et réseau
- Type
- Intégration de la Marketplace
- Marque
- MikroTik
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
mikrotik_extended- Problèmes
- Signaler un problème
