Une intégration moderne, ultra-complète et modulaire pour les routeurs Synology SRM (Synology Router Manager 1.2 / 1.3) : RT2600ac, RT6600ax, WRX560, RT1900ac ainsi que les satellites mesh MR2200ac.
Cette intégration remplace l'ancienne plateforme device_tracker obsolète par une architecture moderne basée sur des entités (ScannerEntity), sans aucun avertissement dans Home Assistant Core 2026/2027+, et apporte la supervision en temps réel de votre connexion Internet, du secours 4G (Smart WAN failover), de votre topologie Mesh et de vos équipements connectés.
L'intégration résout le problème classique des intégrations réseau où 70 téléphones et ampoules IoT viennent inonder la fiche de votre routeur.
- 🏠 Routeur Synology (RT2600ac / RT6600ax / etc.) :
- Regroupe uniquement le matériel et les métriques du routeur principal.
- CPU, RAM, débits Internet, IP WAN, commutateurs Wi-Fi Invité, voyants LED, bouton de redémarrage et mise à jour SRM.
- Zéro client dedans : votre routeur reste propre et lisible !
- 📡 Points d'accès Mesh (MR2200ac / etc.) :
- Chaque borne satellite mesh détectée dispose automatiquement de sa propre fiche appareil dédiée.
- Nombre d'équipements connectés sur cette borne, débits instantanés en réception/émission, temps de fonctionnement propre et nature de la liaison (Liaison Filaire Gigabit Ethernet ou Wi-Fi).
- 📱 Équipements Réseau Connectés :
- Regroupe l'ensemble de vos appareils suivis (
device_tracker) dans une fiche dédiée. - Chaque appareil porte son vrai nom d'origine (
WANSCAM,Redmi-Note-10-Pro, etc.) sans préfixe polluant. - (Option configurable : vous pouvez également choisir de générer une fiche individuelle par appareil si vous le préférez).
- Regroupe l'ensemble de vos appareils suivis (
- Utilisation CPU (%) et Charge CPU détaillée :
Charge CPU (1 min)etCharge CPU (5 min). - Mémoire RAM :
Utilisation Mémoire RAM (%)etMémoire RAM disponible (Mo). - Temps de fonctionnement intelligible (
router_uptime) : Formaté directement en clair (ex:3j 7h 39m) au lieu de secondes brutes illisibles. - Périphérique 4G USB : Détection automatique des modems 4G branchés sur le port USB (ex:
Huawei HUAWEI_MOBILE). - Stockages externes connectés : Décompte des clés et disques durs USB branchés.
- Accès Internet réel (
binary_sensor..._wan_status) : S'appuie sur le Healthy Check réel de SRM (tests de ping et DNS) et pas seulement sur la présence d'une IP locale. - Surveillance du lien principal (
binary_sensor..._primary_wan_status) et du lien 4G de secours (binary_sensor..._secondary_wan_status). - Alerte de bascule 4G (
binary_sensor..._4g_failover_active) : Capteur binaire de type problème/alerte qui s'allume dès que votre trafic bascule sur la clé 4G (idéal pour couper les téléchargements lourds et vous alerter). - Débits Internet en temps réel :
Débit descendant InternetetDébit montant Internet(en Ko/s). - Débits Réseau Local :
Débit Réseau Local (LAN)etDébit Réseau Invité(adieu les noms techniques incompréhensibles commelbr0). - Débits de la borne principale :
Débit descendant borne principaleetDébit montant borne principale.
La distinction entre bornes matérielles et réseaux Wi-Fi est totale :
- Par borne physique (Matériel) :
Appareils sur le routeur principal(ex: 14 appareils sur le salon).Appareils connectés sur le satellite(ex: 31 appareils sur le MR2200ac).
- Par type de réseau (Wi-Fi) :
Appareils sur le Wi-Fi Principal.Appareils sur le Wi-Fi Invité.
- Totaux globaux :
Total appareils connectés.Total appareils Wi-Fi.Total appareils Filaire (Ethernet).
- Basé sur les entités modernes de Home Assistant (
ScannerEntity). - Nommage clair sans préfixe inutile.
- Attributs enrichis sur chaque appareil :
borne_rattachee: Borne physique exacte à laquelle l'appareil est associé (ex:MR2200AC-2T52EE (Satellite)ouSynologyRouter (Principal)).type_connexion:Wi-Fi (5 GHz),Wi-Fi (2.4 GHz)ouFilaire (Ethernet).reseau:Wi-Fi PrincipalouWi-Fi Invité.debit_descendant_kbs&debit_montant_kbs: Débit consommé en direct par l'appareil.signal_dbm&qualite_signal: Force et qualité du signal Wi-Fi.
- Alerte blocage IP (
binary_sensor..._ip_auto_blocked) : Passe àONdès qu'une adresse IP est bannie par le système de sécurité SRM, avec le nombre et la liste des IP bloquées dans les attributs.
- Voyants LED (
switch..._led) : Allumer ou éteindre les LEDs du routeur (idéal pour la nuit). - Réseau Wi-Fi Invité (
switch..._guest_wifi) : Couper ou activer le réseau invité en un clic. - Profils Wi-Fi personnalisés (SRM 1.3) : Création automatique d'un commutateur pour chaque sous-réseau Wi-Fi configuré (ex:
Wi-Fi (PhenixWifi_Invité)). - Bouton de redémarrage (
button..._reboot) : Redémarrer proprement le routeur. - Mise à jour du firmware SRM (
update..._firmware_update) : Avertissement dès qu'une mise à jour SRM est disponible, avec lien direct vers les notes de version Synology.
Important
Étape indispensable pour éviter le bannissement automatique (Erreur 402) :
Le routeur Synology intègre une protection contre les attaques par force brute (Blocage automatique). Si un mot de passe ou un code 2FA est mal saisi ou expire, le routeur bannit immédiatement l'adresse IP de Home Assistant. Dès lors, le routeur rejette toutes les requêtes WebAPI avec l'erreur code: 402 (Permission denied) et tous les capteurs tombent à unknown ou 0.
Pour immuniser Home Assistant définitivement :
- Sur votre routeur Synology SRM, allez dans Centre réseau → Sécurité → onglet Blocage automatique.
- Cliquez sur le bouton Liste d'autorisations (Allow List / Whitelist).
- Cliquez sur Ajouter :
- Sélectionnez Adresse IP spécifique.
- Saisissez l'adresse IP locale de votre Home Assistant (ex:
10.0.4.10).
- Cliquez sur OK pour enregistrer. (Si votre IP a déjà été bannie, allez également dans le bouton Liste de blocage pour supprimer l'IP de Home Assistant).
- Allez dans Panneau de configuration → Utilisateur → Créer.
- Nommez l'utilisateur (ex:
homeassistant) et définissez un mot de passe fort. - Groupe d'utilisateurs : Cochez impérativement le groupe
administrators(indispensable pour interroger les débits et les appareils connectés de SRM). - Applications : Vérifiez que Centre Réseau (Network Center) et SRM sont autorisés.
- Laissez la validation en deux étapes (2FA) désactivée pour ce compte.
Si vous utilisez un compte avec validation en 2 étapes activée :
- Clé secrète OTP Base32 (Recommandé si 2FA) :
Renseignez votre clé secrète OTP (ex:
JBSWY3DPEHPK3PXP, affichée sous le QR code lors de l'activation du 2FA dans SRM). Home Assistant calculera lui-même les codes à 6 chiffres dynamiquement (norme RFC 6238) et renouvellera automatiquement les sessions expirées en arrière-plan sans aucune déconnexion. - Code OTP à 6 chiffres direct :
Vous pouvez renseigner un simple code à 6 chiffres de votre application d'authentification.
Grâce à la gestion du jeton d'appareil de confiance (
device_token) et de l'identifiant de session (sid), votre session reste connectée même après un redémarrage de Home Assistant !
- Dans Home Assistant, ouvrez HACS → Intégrations.
- Cliquez sur les trois points en haut à droite → Dépôts personnalisés.
- Ajoutez l'URL de votre dépôt GitHub avec la catégorie Intégration.
- Cliquez sur Télécharger, puis redémarrez Home Assistant.
- Copiez le dossier
custom_components/synology_srmdans le dossier/config/custom_components/de votre serveur Home Assistant. - Redémarrez Home Assistant.
- Rendez-vous dans Paramètres → Appareils et Services → Ajouter une intégration → Synology SRM Router.
- Renseignez l'IP de votre routeur (ex :
10.0.4.1), votre nom d'utilisateur et votre mot de passe (ainsi que la clé OTP ou le code à 6 chiffres si 2FA est actif). Port par défaut :8011avec SSL activé. - Cliquez sur Soumettre !
En cliquant sur Configurer sur l'intégration, vous pouvez affiner le comportement :
- Intervalle de scrutation (secondes) : Par défaut
15s. - Délai de grâce avant absence (secondes) : Par défaut
180s. - Créer les entités de suivi de présence (Device Tracker) : Permet de désactiver totalement la création des entités de présence si vous souhaitez uniquement surveiller le routeur.
- Regrouper les clients sous un appareil dédié 'Équipements Réseau Connectés' : Activé par défaut (maintient une liste d'appareils ultra propre).
- Activer automatiquement les nouveaux équipements découverts : Si décoché, les nouveaux appareils sont créés à l'état désactivé par défaut (évite que 70 ampoules et prises polluent votre liste).
- Suivre les équipements filaires (Ethernet) : Coché par défaut.
- Activer les logs détaillés (Debug API) : Affiche l'ensemble de la télémétrie SRM dans les journaux de Home Assistant.
Voici un exemple de carte Lovelace propre pour afficher votre routeur et sa borne mesh :
type: vertical-stack
cards:
- type: entities
title: 🏠 Routeur Synology RT2600ac
entities:
- entity: binary_sensor.synology_router_connexion_internet
name: Accès Internet
- entity: sensor.synology_router_adresse_ip_publique_wan
name: IP Publique
- entity: sensor.synology_router_debit_descendant_internet
name: Débit Téléchargement
- entity: sensor.synology_router_debit_montant_internet
name: Débit Envoi
- entity: sensor.synology_router_utilisation_cpu
name: Utilisation CPU
- entity: sensor.synology_router_utilisation_memoire_ram
name: Mémoire RAM
- entity: sensor.synology_router_temps_de_fonctionnement
name: Uptime
- entity: switch.synology_router_wi_fi_invite
name: Wi-Fi Invité
- entity: switch.synology_router_voyants_led
name: Voyants LED
- type: entities
title: 📡 Point d'accès Mesh MR2200ac
entities:
- entity: binary_sensor.mr2200ac_statut_de_la_borne
name: Statut
- entity: binary_sensor.mr2200ac_liaison_filaire_ethernet
name: Liaison Filaire (Ethernet)
- entity: sensor.mr2200ac_appareils_connectes
name: Appareils connectés
- entity: sensor.mr2200ac_debit_descendant
name: Débit descendant
- entity: sensor.mr2200ac_debit_montant
name: Débit montant
- entity: sensor.mr2200ac_temps_de_fonctionnement
name: UptimeSi vous aviez une ancienne configuration dans configuration.yaml :
# À SUPPRIMER DE VOTRE CONFIGURATION.YAML
device_tracker:
- platform: synology_srm
host: 10.0.4.1- L'intégration détectera automatiquement cette section au démarrage et vous enverra une notification ainsi qu'une alerte dans le panneau Système → Réparations.
- Vous pouvez supprimer ce bloc de votre
configuration.yamlune fois configuré via l'interface graphique.