[Externe Integration] AdGuard Home 🛡️

[cicoub13]

Hallo zusammen,

Ich stelle euch eine neue externe Integration für Gladys vor: AdGuard Home. Sie ermöglicht es, den DNS-Schutz Ihres AdGuard-Home-Servers von Gladys aus zu steuern und die Blockierungsstatistiken in Ihren Dashboards und Szenen zu verfolgen.

GitHub-Repository: GitHub - cicoub13/gladys-adguard-home · GitHub

Was die Integration macht

Ein Gerät „AdGuard Home“

Sobald die Verbindung steht, erscheint das Gerät automatisch im Tab Entdeckung, ohne dass ein Scan durchgeführt werden muss. Es bietet:

• 4 Schalter: DNS-Schutz, sicherer Surfmodus, Elternkontrolle, sichere Suche;
• 4 Sensoren (mit Historie): DNS-Anfragen in den letzten 24 Stunden, blockierte Anfragen in den letzten 24 Stunden, Anteil blockierter Anfragen (%) und durchschnittliche Verarbeitungszeit (ms).

Die Schalter spiegeln den tatsächlichen Zustand von AdGuard Home wider: Wenn Sie eine Einstellung über die AdGuard-Oberfläche ändern, erkennt Gladys dies bei der nächsten Aktualisierung.

Zwei Dashboard-Widgets

Übersicht: Die Zahlen der letzten 24 Stunden, die Kurve stundenweise, der Status der Schutzfunktionen und ein Button Pause 10 min / Schutz wieder aufnehmen.

Ranglisten: Zur Auswahl, die am häufigsten blockierten Domains, die am häufigsten angefragten Domains oder die aktivsten Clients.

Zwei Szenenaktionen

• Schutz pausieren für 30 Sekunden, 1 Minute, 10 Minuten, 1 Stunde, 8 Stunden oder 24 Stunden. Die Aktion gibt die Wiederaufnahmezeit (resume_time, im Format HH:MM in Ihrer Zeitzone) zurück, die in eine Benachrichtigung eingefügt werden kann: „DNS-Schutz pausiert bis {{…resume_time}}“.
• Dienste blockieren oder entblockieren aus 25 häufigen Diensten (YouTube, TikTok, Instagram, Netflix, Roblox, Fortnite, Minecraft, ChatGPT…), für das gesamte Netzwerk oder für ein einzelnes Gerät (persistenter AdGuard-Client, bezeichnet durch seinen Namen oder seine IP-Adresse).

Einige Szenenideen:

• Jeden Abend um 21 Uhr TikTok und YouTube auf dem Tablet der Kinder blockieren.
• Ein „Pause Werbung“-Button, der die Blockierung für 10 Minuten deaktiviert, um auf eine Website zuzugreifen, die Blocker ablehnt.
• Jeden Abend die Anzahl der blockierten Anfragen des Tages erhalten.

Installation

1. Sie benötigen Gladys 5.1 oder neuer.
2. Installieren Sie die Integration aus dem Katalog oder direkt über die GitHub-Repository-URL.
3. Geben Sie in der Konfiguration an:
   • die Adresse der Weboberfläche von AdGuard Home, inklusive Port (z. B. http://192.168.1.10:3000 oder Ihre HTTPS-Adresse hinter einem Reverse Proxy);
   • Ihre AdGuard-Home-Benutzername und AdGuard-Home-Kennwort;
   • die Aktualisierungsfrequenz (30 Sekunden, 1 Minute oder 5 Minuten).
4. Klicken Sie auf Verbindung testen, und erstellen Sie das Gerät aus dem Tab Entdeckung.

Die vollständige Dokumentation (inklusive Fehlerbehebung) ist über den Konfigurationsbildschirm zugänglich

Wissenswertes

• Falsches Kennwort: AdGuard Home blockiert eine IP-Adresse für 15 Minuten nach wiederholten falschen Kennworteingaben, einschließlich der Weboberfläche. Um sich nicht selbst auszuschließen, stoppt die Integration ihre Aufrufe, sobald AdGuard das Kennwort ablehnt. Sie setzt die Aufrufe fort, wenn Sie die Konfiguration speichern oder auf „Verbindung testen“ klicken.
• Die „24-Stunden“-Zahlen sind ein gleitendes Fenster, wenn AdGuard seine Statistiken stundenweise speichert. Die Sensoren decken jedoch die gesamte Speicherdauer der AdGuard-Statistiken ab (z. B. 7 Tage).
• Das Widget Ranglisten zeigt die aufgerufenen Domains und die Namen Ihrer Geräte an: Integrieren Sie es nicht in ein Dashboard, in dem andere Benutzer diese Informationen sehen können.
• Die Namen der Gerätefunktionen sind auf Englisch, wie bei meinen anderen Integrationen.

Ihr Feedback

Es ist eine erste Version, getestet mit AdGuard Home v0.107.79. Zögern Sie nicht, mir hier Ihr Feedback zu geben oder ein Issue auf GitHub zu erstellen: Fehler, Dienste, die zur Liste hinzugefügt werden sollen, Ideen für Widgets oder Auslöser…

[guim31]

Top das! Danke @cicoub13