# \[Intégration externe\] AdGuard Home 🛡️

**URL:** <https://community.gladysassistant.com/t/integration-externe-adguard-home/10913>\
**Category:** Développement\
**Tags:** integration-externe\
**Created:** [Septembre 26, 2026, 12:41 UTC](https://community.gladysassistant.com/t/integration-externe-adguard-home/10913 "2026-09-26T12:41:52Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![cicoub13](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/cicoub13/32/4482_2.png) [@cicoub13](https://community.gladysassistant.com/u/cicoub13)\
**Post date:** [Septembre 26, 2026, 12:41 UTC](https://community.gladysassistant.com/t/integration-externe-adguard-home/10913/1 "2026-09-26T12:41:52Z")

</div>

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](https://github.com/cicoub13/gladys-adguard-home)

## 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](https://raw.githubusercontent.com/cicoub13/gladys-adguard-home/main/docs/images/widget-overview.png)

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

![Widget Classements](https://raw.githubusercontent.com/cicoub13/gladys-adguard-home/main/docs/images/widget-ranking.png)

### 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

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

- 🔒 **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…

---

<div class="post-metadata">

**Author:** ![guim31](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/guim31/32/4840_2.png) [@guim31](https://community.gladysassistant.com/u/guim31)\
**Post date:** [Septembre 26, 2026, 1:35 UTC](https://community.gladysassistant.com/t/integration-externe-adguard-home/10913/2 "2026-09-26T13:35:57Z")

</div>

Top ça ! Merci @cicoub13😉