AdGuard Home
Incluse avec Macro DeckActivez, désactivez ou mettez en pause la protection AdGuard Home, et affichez ses statistiques sur votre deck.
Des widgets AdGuard Home en quatre tailles qui indiquent que la protection est activée, avec des boutons pour la mettre en pause
- Mettez la protection en pause de 5 minutes à 24 heures, ou pour une durée personnalisée
- Basculez la protection et le filtrage avec des boutons qui affichent l'état
- Un widget avec des boutons de pause et des statistiques DNS
- Des variables pour les requêtes, la part bloquée et le temps de réponse
- Ajoutez autant de serveurs AdGuard Home que vous le souhaitez
L'intégration AdGuard Home relie Macro Deck à l'interface web d'AdGuard Home : elle fonctionne donc avec tout AdGuard Home que vous pouvez ouvrir dans un navigateur, sur votre routeur, un Raspberry Pi, un serveur domestique ou un VPS. Vous pouvez ajouter autant de serveurs que vous le souhaitez, par exemple un à la maison et un au bureau, et choisir le serveur dans chaque action et chaque widget.
Ce que vous pouvez faire
- Activer ou désactiver la protection, la basculer, ou la désactiver temporairement pendant 5, 15 ou 30 minutes, 1, 2, 8 ou 24 heures, ou pour une durée personnalisée allant jusqu'à 7 jours. AdGuard Home la réactive tout seul.
- Activer ou désactiver le blocage par listes de filtres sans modifier les autres réglages de protection, et télécharger la dernière version de chaque liste de filtres.
- Ajouter le widget AdGuard Home pour afficher l'état de la protection avec des boutons de pause, les statistiques, ou les deux.
- Utiliser les variables pour afficher sur n'importe quel bouton le nombre de requêtes DNS, la part bloquée ou le temps de réponse moyen.
Quelques exemples de configuration :
- Un bouton Pause pubs avec Désactiver temporairement la protection pendant 15 minutes, pour un site qui ne fonctionne pas avec le blocage.
- Un bouton avec Basculer la protection qui s'allume tant que la protection est active.
- Un widget AdGuard Home en mode Contrôles et statistiques qui affiche l'état de la protection, des boutons de pause et le nombre de requêtes bloquées.
Fonctionnement
Macro Deck demande à chaque serveur son état toutes les 5 secondes et ses statistiques toutes les 30 secondes. Tous les widgets et toutes les variables d'un serveur utilisent les mêmes réponses : ajouter des widgets n'ajoute donc aucune requête. Après une action, l'état est relu immédiatement. Quand un serveur est injoignable ou refuse l'authentification, sa variable adguard_home_<instance>_is_reachable vaut false, les autres variables apparaissent comme indisponibles et le widget l'indique au lieu d'afficher d'anciens chiffres. Macro Deck réessaie toutes les 30 secondes et se met à jour tout seul dès que le serveur est de retour.
Ce qu'il vous faut
- Un AdGuard Home dont l'interface web est accessible depuis Macro Deck, par exemple
http://192.168.1.2:3000. - Le nom d'utilisateur et le mot de passe avec lesquels vous vous connectez à AdGuard Home, s'il demande une connexion.
- Pour une adresse
https://: un certificat approuvé par votre ordinateur, ou l'option Accepter un certificat autosigné.
Configuration
Étape 1: Trouvez l'adresse d'AdGuard Home
Ouvrez l'interface web d'AdGuard Home dans un navigateur et notez l'adresse avec le port, par exemple
http://192.168.1.2:3000. Si AdGuard Home se trouve derrière un reverse proxy sous un chemin, notez aussi ce chemin.Étape 2: Ouvrez l'intégration AdGuard Home
Dans Macro Deck, cliquez sur Intégrations dans la barre latérale, puis sur AdGuard Home. Dans l'onglet Aperçu, cliquez sur Ajouter une configuration dans la section Configuration. Activer l'interrupteur en haut à droite ouvre la même boîte de dialogue, et l'intégration est activée une fois la configuration terminée.
Étape 3: Saisissez les informations du serveur
Dans la boîte de dialogue Se connecter à AdGuard Home, saisissez :
- Nom de la configuration : le nom du serveur dans les actions et les widgets, par exemple
Home. - Adresse : l'adresse de l'interface web, port compris.
- Nom d'utilisateur et Mot de passe : le compte avec lequel vous vous connectez à AdGuard Home. Laissez les deux vides si AdGuard Home ne demande pas de connexion.
- Accepter un certificat autosigné : uniquement pour une adresse
https://dont le certificat n'est pas approuvé par votre ordinateur.
Cliquez sur Continuer. Macro Deck vérifie la connexion avant d'enregistrer la configuration.
- Nom de la configuration : le nom du serveur dans les actions et les widgets, par exemple
Étape 4: Ajoutez une action à un bouton
Sur la page Deck, cliquez sur un bouton. Le deck doit être déverrouillé : c'est le cas lorsque le bouton Verrouiller s'affiche en haut à droite. L'éditeur s'ouvre avec Appui court sélectionné. Cliquez sur + Ajouter une action, sélectionnez AdGuard Home à gauche de la boîte de dialogue Ajouter une action, choisissez Désactiver temporairement la protection, sélectionnez le serveur sous Instance et choisissez une Durée.
Étape 5: Appuyez sur le bouton
Appuyez sur le bouton de votre deck. AdGuard Home met la protection en pause et la réactive tout seul une fois le délai écoulé.
Étape 6: Ajoutez le widget
Pour voir l'état d'un coup d'œil, ajoutez le widget AdGuard Home à un dossier. Dans ses réglages, choisissez l'Instance, l'Affichage (Contrôles de la protection, Statistiques ou Contrôles et statistiques), les Boutons de pause et les Statistiques à afficher.
Actions8
Placez-les sur un bouton ou exécutez-les depuis un flux.
- Activer la protection
- Active la protection, ce qui met aussi fin à une pause.
- Désactiver la protection
- Désactive la protection jusqu'à ce que vous la réactiviez.
- Basculer la protection
- Active la protection si elle est désactivée, et la désactive si elle est active. Le bouton s'allume tant que la protection est active.
- Désactiver temporairement la protection
- Désactive la protection pour une durée définie allant jusqu'à 7 jours. AdGuard Home la réactive tout seul.
- Activer le filtrage
- Active le blocage par listes de filtres.
- Désactiver le filtrage
- Désactive le blocage par listes de filtres. Le reste de la protection ne change pas.
- Basculer le filtrage
- Active le blocage par listes de filtres s'il est désactivé, et le désactive s'il est actif.
- Mettre à jour les listes de filtres
- Télécharge la dernière version de chaque liste de blocage et d'autorisation.
Variables8
Affichez ces valeurs sur des boutons et des widgets, ou utilisez-les dans des conditions.
adguard_home_<instance>_is_reachable- Indique si Macro Deck peut actuellement joindre le serveur.
adguard_home_<instance>_protection_enabled- Indique si la protection est active.
adguard_home_<instance>_protection_disabled_until- La fin d'une pause, au format ISO 8601, ou vide.
adguard_home_<instance>_dns_queries,adguard_home_<instance>_blocked_queries- Toutes les requêtes DNS et celles bloquées par les listes de filtres.
adguard_home_<instance>_blocked_percentage- Les requêtes bloquées en pourcentage de toutes les requêtes.
adguard_home_<instance>_avg_processing_time- Le temps de réponse moyen en millisecondes.
adguard_home_<instance>_safebrowsing_blocked,adguard_home_<instance>_parental_blocked,adguard_home_<instance>_safesearch_enforced- Le nombre de logiciels malveillants et de tentatives d'hameçonnage bloqués, de sites pour adultes bloqués et de recherches sécurisées imposées.
adguard_home_<instance>_version- La version d'AdGuard Home.
Widgets1
Ajoutez-les à votre deck depuis le sélecteur de widgets.
- AdGuard Home
- Affiche l'état de la protection et les statistiques d'un serveur, avec des boutons pour mettre la protection en pause ou la réactiver.
Questions fréquentes
Puis-je piloter plusieurs AdGuard Home ?
Oui. Ajoutez une configuration par serveur. Chaque action et chaque widget possède un champ Instance, et chaque serveur a ses propres variables, nommées d'après le nom de configuration qu'il avait lors de son ajout.
AdGuard Home doit-il tourner sur le même ordinateur ?
Non. Macro Deck communique avec l'interface web par le réseau : AdGuard Home peut donc tourner sur un routeur, un Raspberry Pi ou un VPS, tant que Macro Deck peut joindre son adresse.
Pourquoi une action échoue-t-elle ?
L'action affiche un message quand le serveur est injoignable, refuse l'authentification ou ne prend pas en charge la requête. Un serveur qui refuse l'authentification indique sur la page Intégrations qu'il doit être reconfiguré.
Quelle période les statistiques couvrent-elles ?
La période pendant laquelle AdGuard Home conserve ses statistiques, soit 24 heures sauf si vous l'avez modifiée dans AdGuard Home.
Où mon mot de passe est-il stocké ?
Le mot de passe est stocké chiffré sur votre ordinateur et n'est jamais envoyé au deck ni à un navigateur.
Plus dans Maison connectée et web
Home Assistant
Incluse avec Macro DeckAllumez les lumières, lancez des scènes et des scripts, et affichez sur votre deck les états en direct de votre Home Assistant.
Flux RSS
Incluse avec Macro DeckSuivez des flux RSS et Atom, affichez leurs derniers articles dans des widgets et réagissez à l'arrivée de nouveaux articles.
HTTP
Incluse avec Macro DeckEnvoyez des requêtes HTTP depuis un bouton et enregistrez des valeurs de la réponse dans des variables.
Météo
Incluse avec Macro DeckAffichez sur votre deck la météo actuelle et les prévisions pour vos lieux, sans clé d'API.