HYVIA Network Guardian
Guide d'installation complet
Isle Saint-Maur
Infrastructure réseau HYVIA

Network Guardian
Isle Saint-Maur

Ce guide installe un système de surveillance réseau autonome : détection automatique des pannes, basculement Freebox → Starlink, reboot à distance, et alertes Telegram instantanées — sans intervention humaine.

~2h d'installation ~275€ de matériel Mac permanent existant Alertes Telegram
1

Matériel à commander

3 références Amazon — total ~275€

MatérielRôleStatutPrixLien
TP-Link TL-SG3452
Switch 48 ports managé Omada		 STP anti-boucle + 48 ports À commander ~200€ amazon.fr/dp/B077HT9WTW
TP-Link ER605
Routeur Omada dual-WAN		 Bascule auto Freebox→Starlink À commander ~60€ amazon.fr/dp/B08MH4VLR3
TP-Link Tapo P110
Prise connectée Wi-Fi		 Reboot matériel Freebox À commander ~15€ amazon.fr/dp/B09BFT7NZJ
TL-SG3428
Switch 24 ports managé Omada		 Cascade avec le TL-SG3452 Déjà en place 0€ —
Mac permanent clinique
Mac allumé en permanence		 Watchdog + dashboard web Déjà en place 0€ —
2

Schéma réseau cible

Architecture complète après installation

[ Freebox Pro ] ──WAN1──┐ ├──▶ [ ER605 Omada ] ──LAN──▶ [ TL-SG3452 ] ──cascade──▶ [ TL-SG3428 ] [ Starlink ] ─────WAN2──┘ (dual-WAN failover) (48 ports + STP) (24 ports + STP) │ Tous les Macs + imprimantes de la clinique (70 ports dispo) [ Tapo P110 ] ──alim──▶ [ Freebox Pro ] (prise connectée sur l'alimentation — reboot à distance) [ Mac permanent ] ──(sur le réseau local)──▶ surveille toutes les 30s → alerte Telegram si panne → reboot auto via API Freebox ou Tapo → dashboard web sur http://[IP-MAC]:5000
3

Installation physique

Câblage réseau — ~30 min

Brancher la Tapo P110 sur la prise murale

Insère la prise Tapo P110 dans une prise murale proche de la Freebox. Branche ensuite le câble d'alimentation de la Freebox Pro dans la Tapo (pas directement dans le mur). La Tapo contrôle l'alimentation de la Freebox.

Configurer la Tapo dans l'app (avant de continuer)

Télécharge l'app TP-Link Tapo sur ton téléphone. Ajoute la prise P110 (bouton + dans l'app). Note son IP locale (visible dans l'app → Infos appareil). Tu en auras besoin plus tard.

Brancher le ER605 entre la Freebox et le TL-SG3452

Câble 1 : Port LAN de la Freebox Pro → Port WAN1 du ER605.
Câble 2 : Port LAN de la Starlink box → Port WAN2 du ER605.
Câble 3 : Port LAN1 du ER605 → Port uplink du TL-SG3452.

Cascader le TL-SG3428 sur le TL-SG3452

Câble Cat6 : Port SFP ou RJ45 disponible du TL-SG3452 → Port uplink du TL-SG3428. Ce câble relie les deux switches entre eux. Total disponible : 70 ports.

Vérifier que tous les équipements s'allument

Redémarre dans cet ordre : 1/ Freebox Pro → 2/ Starlink → 3/ ER605 → 4/ TL-SG3452 → 5/ TL-SG3428. Attends 2 minutes. Les Macs doivent retrouver internet.

La Starlink doit être en mode Bypass pour que le ER605 gère le routage. Active-le dans l'app Starlink : Paramètres → Mode routeur → Désactivé (Bypass).
4

Configurer le ER605 — Dual WAN + Failover

Basculement automatique Freebox → Starlink

Accéder à l'interface admin du ER605

Depuis un Mac sur le réseau, ouvre un navigateur et va sur http://192.168.0.1 (IP par défaut ER605). Login : admin / admin (change le mot de passe immédiatement).

Configurer WAN1 (Freebox) et WAN2 (Starlink)

Menu Internet → WAN. WAN1 : type DHCP (Freebox assigne automatiquement). WAN2 : type DHCP (Starlink assigne automatiquement). Sauvegarde.

Activer le failover automatique

Menu Internet → Load Balancing. Sélectionne le mode Failover (pas Load Balance). WAN1 = primaire. WAN2 = backup. Méthode de détection : Ping vers 8.8.8.8. Intervalle : 10s. Seuil d'échec : 3 tentatives. Sauvegarde.

Tester le failover

Débranche le câble WAN1 (Freebox). Attends 30 secondes. Internet doit rester disponible via Starlink. Rebranche WAN1 : le ER605 doit revenir automatiquement sur la Freebox en moins d'une minute.

5

Activer le STP sur les deux switches

Protection définitive contre les boucles réseau

Le STP (Spanning Tree Protocol) détecte automatiquement les boucles réseau (câble branché deux fois sur le même switch) et bloque le port fautif. C'est la solution au problème d'aujourd'hui.

TL-SG3452 (switch principal)

Ouvrir l'interface web du switch

Trouve son IP dans le ER605 (DHCP clients) ou via l'app Omada. Ouvre dans un navigateur.

Activer RSTP globalement

Menu L2 Features → STP → STP Config. Mode : RSTP. Status : Enable. Sauvegarde.

TL-SG3428 (switch secondaire)

Répéter sur le TL-SG3428

Même procédure. Menu L2 Features → STP → STP Config. Mode : RSTP. Status : Enable. Sauvegarde.

Tester : brancher un câble en boucle

Prends un câble, branche-le sur deux ports du même switch. Au bout de 5s le STP doit bloquer l'un des ports automatiquement — internet reste disponible.

6

Installer le Watchdog sur le Mac permanent

Surveillance automatique toutes les 30 secondes

Avant tout : sur ce Mac, va dans Réglages Système → Batterie / Économiseur d'énergie → Empêcher le Mac de passer en veille automatiquement. Active aussi "Démarrer automatiquement après une coupure de courant".
Copier le dossier projet sur le Mac

Depuis ton Mac personnel, ouvre un Terminal et envoie le dossier au Mac de la clinique :

Terminal — sur ton Mac
scp -r ~/HYVIA\ Battle/HYVIA_network_guardian/ [USER]@[IP-MAC-CLINIQUE]:~/

Remplace [USER] par le nom d'utilisateur du Mac clinique et [IP-MAC-CLINIQUE] par son adresse IP locale.

Se connecter en SSH au Mac clinique et installer les dépendances
Terminal
ssh [USER]@[IP-MAC-CLINIQUE] cd ~/hyvia_network_guardian pip3 install -r requirements.txt

Si pip3 n'est pas installé : /usr/bin/python3 -m ensurepip && python3 -m pip install --upgrade pip

Créer le fichier .env
Terminal — sur le Mac clinique
cd ~/hyvia_network_guardian cp .env.example .env nano .env

Remplis les champs : TELEGRAM_BOT_TOKEN (token de Hermès), TELEGRAM_CHAT_GAUTIER (ton chat ID), GATEWAY_IP (IP du ER605, souvent 192.168.0.1), TAPO_EMAIL / PASSWORD / FREEBOX_IP.

Créer le service launchd (démarrage automatique)

Sur Mac, le service qui remplace systemd s'appelle launchd. Crée le fichier :

Terminal — sur le Mac clinique
nano ~/Library/LaunchAgents/fr.hyvia.network-guardian.plist

Colle ce contenu (adapte les chemins avec le bon nom d'utilisateur) :

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "..."> <plist version="1.0"> <dict> <key>Label</key> <string>fr.hyvia.network-guardian</string> <key>ProgramArguments</key> <array> <string>/usr/bin/python3</string> <string>/Users/[USER]/hyvia_network_guardian/watchdog.py</string> </array> <key>WorkingDirectory</key> <string>/Users/[USER]/hyvia_network_guardian</string> <key>RunAtLoad</key><true/> <key>KeepAlive</key><true/> <key>StandardOutPath</key> <string>/Users/[USER]/hyvia_network_guardian/watchdog.log</string> <key>StandardErrorPath</key> <string>/Users/[USER]/hyvia_network_guardian/watchdog.log</string> </dict> </plist>
Activer et démarrer le service
Terminal — sur le Mac clinique
launchctl load ~/Library/LaunchAgents/fr.hyvia.network-guardian.plist launchctl start fr.hyvia.network-guardian

Tu dois recevoir un message Telegram : 🟢 HYVIA Network Guardian démarré — Isle Saint-Maur

7

Enregistrer l'app auprès de la Freebox

Autorisation unique — bouton physique requis

Cette étape nécessite d'être physiquement devant la Freebox Pro pour appuyer sur son bouton fléché. Elle ne se fait qu'une seule fois.
Vérifier que l'URL Freebox répond

Dans un navigateur sur le réseau local :

http://mafreebox.freebox.fr/api_version

Tu dois voir un JSON avec api_version. Si ça ne répond pas, essaie avec l'IP du ER605 ou 192.168.1.254. Note l'URL qui fonctionne et mets-la dans le .env → FREEBOX_URL.

Lancer le script d'enregistrement
Terminal — sur le Mac clinique
cd ~/hyvia_network_guardian python3 register_freebox.py
Appuyer sur le bouton › de la Freebox Pro

Quand le script affiche "APPUIE sur le bouton ›", appuie sur le bouton fléché à l'avant de la Freebox dans les 3 minutes. Le script affiche ensuite : ✅ Token sauvegardé.

8

Configurer la Tapo P110

Reboot matériel Freebox à distance

Créer un compte TP-Link (si pas encore fait)

Télécharge l'app TP-Link Tapo. Crée un compte avec un email HYVIA. Ce compte permet le contrôle cloud de la prise (même depuis l'extérieur).

Ajouter la prise dans l'app et noter son IP

Dans l'app Tapo → + → Ajouter un appareil → P110. Suis le guide. Une fois configurée : Infos de l'appareil → Adresse IP. Note cette IP et entre-la dans .env → TAPO_FREEBOX_IP.

Tester le reboot à distance

Dans le Terminal du Mac clinique :

cd ~/hyvia_network_guardian python3 -c "import smart_plug; ok, msg = smart_plug.power_cycle_freebox(); print(ok, msg)"

La Freebox doit s'éteindre 12 secondes puis se rallumer.

★

Guide secrétaires — que faire en cas de panne ?

À imprimer et afficher près des postes

Dans la grande majorité des cas, le système se corrige tout seul. Si une panne est détectée, le watchdog tente le reboot automatique. Vous recevez une alerte Telegram et n'avez rien à faire.

Plus d'internet — câble vert mais rien ne charge

  1. 1Attends 2 minutes — le watchdog est peut-être en train de corriger automatiquement.
  2. 2Vérifie Telegram — Gautier a déjà été alerté avec le diagnostic.
  3. 3Si toujours KO après 5 min : contacte Gautier via Telegram ou téléphone.

Boucle réseau suspectée (câble branché 2 fois)

  1. 1Le STP devrait l'avoir bloqué automatiquement. Vérifie que l'internet revient.
  2. 2Si non : cherche un câble Ethernet dont les deux extrémités sont sur le même switch et débranchez-le.
  3. 3Prévenez Gautier.

Dashboard réseau en temps réel

Accessible sur http://[IP-MAC-CLINIQUE]:5000 depuis n'importe quel appareil sur le réseau de la clinique.

🎉

Installation terminée !

HYVIA Network Guardian est opérationnel. Surveillance active, basculement automatique et alertes Telegram configurés.

Retour Connect