Bonjour Ă tous,
Je vous présente une nouvelle intégration externe pour Gladys : AdGuard Home. Elle permet de piloter la protection DNS de votre serveur AdGuard Home depuis Gladys et de suivre ses statistiques de blocage dans vos tableaux de bord et vos scènes.
Dépôt GitHub : GitHub - cicoub13/gladys-adguard-home · GitHub
Ce que fait l’intégration
Un appareil « AdGuard Home »
Dès que la connexion fonctionne, l’appareil apparaît tout seul dans l’onglet Découverte, sans lancer de scan. Il propose :
- 4 interrupteurs : protection DNS, navigation sécurisée, contrôle parental, recherche sécurisée ;
- 4 capteurs (avec historique) : requêtes DNS sur 24 h, requêtes bloquées sur 24 h, part de requêtes bloquées (%) et temps de traitement moyen (ms).
Les interrupteurs reflètent l’état réel d’AdGuard Home : si vous changez un réglage depuis l’interface d’AdGuard, Gladys le voit au rafraîchissement suivant.
Deux widgets de tableau de bord
Vue d’ensemble : les chiffres des dernières 24 h, la courbe heure par heure, l’état des protections, et un bouton Pause 10 min / Reprendre la protection.

Classements : au choix, les domaines les plus bloqués, les domaines les plus demandés ou les clients les plus actifs.

Deux actions de scène
- Mettre la protection en pause pendant 30 s, 1 min, 10 min, 1 h, 8 h ou 24 h. L’action renvoie l’heure de reprise (
resume_time, au format HH:MM dans votre fuseau horaire), à glisser dans une notification : « Protection DNS en pause jusqu’à {{…resume_time}} ». - Bloquer ou débloquer des services parmi 25 services courants (YouTube, TikTok, Instagram, Netflix, Roblox, Fortnite, Minecraft, ChatGPT…), pour tout le réseau ou pour un seul appareil (client persistant d’AdGuard, désigné par son nom ou son IP).
Quelques idées de scènes :
Tous les soirs Ă 21 h, bloquer TikTok et YouTube sur la tablette des enfants.
Un bouton « Pause pub » qui coupe le blocage 10 minutes, le temps d’accéder à un site qui refuse les bloqueurs.
Tous les soirs, recevoir le nombre de requêtes bloquées dans la journée.
Installation
- Il faut Gladys 5.1 ou plus récent.
- Installez l’intégration depuis le catalogue, ou directement depuis l’URL du dépôt GitHub.
- Dans la configuration, renseignez :
- l’adresse de l’interface web d’AdGuard Home, port compris (par exemple
http://192.168.1.10:3000, ou votre adresse HTTPS derrière un reverse proxy) ; - votre identifiant et votre mot de passe AdGuard Home ;
- la fréquence de rafraîchissement (30 s, 1 min ou 5 min).
- l’adresse de l’interface web d’AdGuard Home, port compris (par exemple
- Cliquez sur Tester la connexion, puis créez l’appareil depuis l’onglet Découverte.
La documentation complète (dépannage compris) est accessible depuis l’écran de configuration
Bon Ă savoir
Mot de passe erroné : AdGuard Home bloque une adresse IP pendant 15 minutes après une répétition de mauvais mots de passe, interface web comprise. Pour ne pas vous enfermer dehors, l’intégration arrête ses appels dès qu’AdGuard refuse le mot de passe. Elle reprend quand vous enregistrez la configuration ou cliquez sur « Tester la connexion ».
Les chiffres « 24 h » sont une fenêtre glissante quand AdGuard conserve ses statistiques par tranches horaires. Les capteurs, eux, couvrent toute la durée de conservation des statistiques d’AdGuard (par exemple 7 jours).
Le widget Classements affiche les domaines consultés et les noms de vos appareils : ne l’intégrez pas dans un tableau de bord où d’autres utilisateurs peuvent voir ces informations.- Les noms des fonctionnalités de l’appareil sont en anglais, comme pour mes autres intégrations.
Vos retours
C’est une première version, testée sur AdGuard Home v0.107.79. N’hésitez pas à me faire vos retours ici ou à ouvrir une issue sur GitHub : bugs, services à ajouter à la liste, idées de widgets ou de déclencheurs…