[Intégration externe] AdGuard Home 🛡️

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.

:backhand_index_pointing_right: 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.

Widget Vue d'ensemble

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

Widget Classements

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 :

  • :television: Tous les soirs Ă  21 h, bloquer TikTok et YouTube sur la tablette des enfants.
  • :shopping_cart: Un bouton « Pause pub » qui coupe le blocage 10 minutes, le temps d’accĂ©der Ă  un site qui refuse les bloqueurs.
  • :bar_chart: Tous les soirs, recevoir le nombre de requĂŞtes bloquĂ©es dans la journĂ©e.

Installation

  1. Il faut Gladys 5.1 ou plus récent.
  2. Installez l’intégration depuis le catalogue, ou directement depuis l’URL du dépôt GitHub.
  3. 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).
  4. 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

  • :locked: 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 ».
  • :chart_increasing: 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).
  • :eyes: 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…

Top ça ! Merci @cicoub13 :wink: