Adguard im HA (Home Assistant) einrichten: Eine Schritt-für-Schritt-Anleitung für werbefreies Surfen

In einer Welt, die zunehmend von Online-Werbung, Trackern und potenziell schädlichen Inhalten dominiert wird, suchen immer mehr Nutzer nach Wegen, ihre digitale Privatsphäre und ihren Seelenfrieden zu schützen. Für Nutzer von Home Assistant (HA), dem beliebten Open-Source-Automatisierungsserver, gibt es eine elegante Lösung: die Integration von AdGuard Home. Diese leistungsstarke Kombination ermöglicht es Ihnen, Ihr gesamtes Heimnetzwerk werbefrei zu machen, Tracking zu unterbinden und die Kontrolle über Ihren DNS-Verkehr zurückzugewinnen – alles bequem von Ihrer Home Assistant-Oberfläche aus.

Dieser umfassende Leitfaden führt Sie Schritt für Schritt durch den Prozess der Installation und Konfiguration von AdGuard Home als Add-on in Home Assistant und zeigt Ihnen, wie Sie die volle Leistungsfähigkeit dieser Integration nutzen können. Machen Sie sich bereit für ein sauberes, schnelles und sicheres Surferlebnis!

Warum AdGuard Home in Home Assistant?

Die Integration von AdGuard Home in Home Assistant bietet eine Vielzahl von Vorteilen, die weit über das einfache Blockieren von Werbung hinausgehen:

• Netzwerkweite Werbeblockierung: Blockiert Werbung und Pop-ups auf allen Geräten in Ihrem Netzwerk – Smartphones, Tablets, Smart-TVs und sogar IoT-Geräten – ohne dass dafür separate Apps oder Browser-Erweiterungen erforderlich sind.
• Verbesserte Privatsphäre: Blockiert Tracker und Analytics-Skripte, die Ihre Online-Aktivitäten verfolgen könnten.
• Erhöhte Sicherheit: Schützt vor Phishing, Malware und anderen bösartigen Domains, indem der Zugriff auf bekannte schädliche Websites verhindert wird.
• Elterliche Kontrolle: Ermöglicht das Blockieren unerwünschter Inhalte und den Zugriff auf bestimmte Websites zu festgelegten Zeiten.
• Transparenz und Kontrolle: Detaillierte Statistiken und Abfrageprotokolle zeigen Ihnen, welche Geräte Anfragen stellen und welche Domains blockiert werden.
• Leistungssteigerung: Durch das Blockieren von unerwünschten Inhalten werden Webseiten schneller geladen und Ihr Netzwerkverkehr reduziert.
• Zentrale Verwaltung: Alles wird direkt von Ihrer Home Assistant-Instanz aus verwaltet, was die Wartung vereinfacht.

Voraussetzungen für die Installation

Bevor wir loslegen, stellen Sie sicher, dass Sie die folgenden Punkte erfüllen:

• Eine funktionierende Home Assistant-Installation (vorzugsweise Home Assistant OS oder Supervised).
• Administrativen Zugriff auf Ihre Home Assistant-Instanz.
• Grundkenntnisse in der Netzwerkadministration (z.B. Verständnis von DNS und Router-Einstellungen).
• Zugriff auf die Konfiguration Ihres Routers, um später die DNS-Einstellungen anzupassen.

Schritt 1: AdGuard Home als Add-on in Home Assistant installieren

Die einfachste und empfohlene Methode, AdGuard Home in Home Assistant zu betreiben, ist die Installation als offizielles Add-on. Das erspart Ihnen das Einrichten eines separaten Servers oder einer Docker-Instanz.

1.1 Navigieren zum Add-on Store

Öffnen Sie Ihre Home Assistant-Benutzeroberfläche und gehen Sie wie folgt vor:

1. Klicken Sie in der linken Seitenleiste auf Einstellungen.
2. Wählen Sie Add-ons aus.
3. Klicken Sie unten rechts auf den Button ADD-ON STORE.

1.2 AdGuard Home suchen und installieren

Im Add-on Store sehen Sie eine Liste der verfügbaren Add-ons:

1. Geben Sie in der Suchleiste oben AdGuard Home ein.
2. Klicken Sie auf das Ergebnis AdGuard Home.
3. Auf der Detailseite des Add-ons klicken Sie auf den Button INSTALLIEREN.
4. Warten Sie, bis der Installationsvorgang abgeschlossen ist. Dies kann einige Minuten dauern, abhängig von Ihrer Internetverbindung und der Leistung Ihres Home Assistant-Servers.

Schritt 2: Grundkonfiguration des AdGuard Home Add-ons

Nach der Installation müssen einige grundlegende Einstellungen vorgenommen werden, bevor Sie AdGuard Home starten können.

2.1 Ports und Netzwerk anpassen (optional, aber empfohlen)

Bevor Sie das Add-on starten, überprüfen Sie die Netzwerkeinstellungen. Standardmäßig verwendet AdGuard Home die Ports 53 (DNS), 80 (Web-UI) und 443 (Web-UI HTTPS). Wenn Sie bereits andere Dienste auf diesen Ports laufen haben, müssen Sie diese anpassen. Für die meisten Nutzer sind die Standardeinstellungen jedoch in Ordnung.

1. Gehen Sie zurück zur Detailseite des AdGuard Home Add-ons (Einstellungen > Add-ons > AdGuard Home).
2. Wechseln Sie zum Reiter Konfiguration.
3. Hier finden Sie die Einstellungen für die Portzuweisung unter ports. Standardmäßig sollte dies wie folgt aussehen:

   
       dns: 53
       dashboard: 3000
       

   Der DNS-Port 53 ist essenziell und sollte nicht geändert werden, es sei denn, Sie wissen genau, was Sie tun. Der dashboard-Port kann angepasst werden, wenn Port 3000 bereits belegt ist.

   Wichtiger Hinweis: AdGuard Home lauscht auf Port 53, der auch vom internen DNS-Server von Home Assistant genutzt werden kann. Wenn Sie Probleme beim Starten haben, stellen Sie sicher, dass keine anderen Dienste Port 53 belegen. Das Add-on selbst wird in einem isolierten Container ausgeführt, sodass es selten zu direkten Konflikten mit dem Host-System kommt, aber andere Add-ons könnten Ports belegen.

2.2 Starten des Add-ons

1. Nachdem Sie die Konfiguration überprüft haben, wechseln Sie zum Reiter Info.
2. Aktivieren Sie die Option Beim Starten booten und Watchdog (optional, aber empfohlen, damit AdGuard Home bei Problemen automatisch neu startet).
3. Klicken Sie auf STARTEN.
4. Überprüfen Sie den Reiter Protokolle, um sicherzustellen, dass AdGuard Home ohne Fehler startet. Es sollte Meldungen wie AdGuard Home is running anzeigen.

Schritt 3: Erstmalige Konfiguration der AdGuard Home Web-Oberfläche

Nachdem AdGuard Home gestartet ist, können Sie auf dessen Web-Oberfläche zugreifen, um die Feinabstimmung vorzunehmen.

3.1 Zugriff auf die Web-Oberfläche

1. Gehen Sie auf die Detailseite des AdGuard Home Add-ons in Home Assistant.
2. Klicken Sie auf WEB UI ÖFFNEN. Dies leitet Sie zu der AdGuard Home-Oberfläche um, typischerweise auf Port 3000 Ihrer Home Assistant IP-Adresse (z.B. http://[Ihre_HA_IP]:3000).

3.2 Erster Einrichtungsassistent

Beim ersten Zugriff werden Sie von einem Einrichtungsassistenten begrüßt:

1. Willkommen: Klicken Sie auf Los geht's!.
2. Web-Oberfläche-Port: Lassen Sie den Standard-Port (z.B. 3000) oder passen Sie ihn an, falls er zuvor im Add-on geändert wurde.
3. DNS-Server-Port: Lassen Sie den Standard-Port 53.
4. Admin-Benutzer erstellen: Legen Sie einen Benutzernamen und ein sicheres Passwort für den Zugriff auf die AdGuard Home-Oberfläche fest. Dies ist extrem wichtig für die Sicherheit!
5. Fertigstellen: Nach der Eingabe klicken Sie auf Weiter und dann Öffnen Sie das Dashboard.

3.3 Dashboard und Einstellungen

Sie befinden sich nun auf dem AdGuard Home Dashboard. Hier sind einige wichtige Einstellungen, die Sie vornehmen sollten:

1. Filterlisten (Filter > DNS-Filter):
   • Standardmäßig sind bereits einige Listen aktiviert (z.B. AdGuard DNS filter).
   • Klicken Sie auf Filterliste hinzufügen und dann auf Liste aus der Community auswählen. Empfehlenswerte zusätzliche Listen sind:
     • OISD Full: Eine sehr umfassende Liste, die Werbung, Tracker und Malware blockiert.
     • No Tracking: Speziell zum Blockieren von Tracking-Domains.
     • Suchen Sie nach spezifischen Listen, die Ihren Bedürfnissen entsprechen (z.B. Listen für deutsche Werbung, falls nötig).
   • Vergessen Sie nicht, Anwenden zu klicken, um die Änderungen zu speichern.
2. DNS-Einstellungen (Einstellungen > DNS-Einstellungen):
   • Upstream-DNS-Server: Dies sind die Server, die AdGuard Home für die Namensauflösung verwendet, wenn eine Domain nicht blockiert werden soll. Empfehlenswert sind datenschutzfreundliche Server wie:
     • 1.1.1.1 (Cloudflare)
     • 1.0.0.1 (Cloudflare)
     • 9.9.9.9 (Quad9 – mit Sicherheit)
     • 8.8.8.8 (Google Public DNS)

     Sie können mehrere Server hinzufügen, AdGuard Home verwendet diese parallel für schnellere Auflösung.

   • Bootstrap-DNS-Server: Dies sind DNS-Server, die für die Auflösung der Upstream-Server-Adressen verwendet werden. Normalerweise können Sie hier die gleichen wie bei den Upstream-Servern eintragen.
   • Aktivieren Sie Parallele Anfragen und optional DNSSEC-Schutz und EDNS Client Subnet (ECSS – kann für standortbasierte Inhalte nützlich sein, aber reduziert die Privatsphäre).
   • Speichern Sie die Einstellungen.

Schritt 4: Integration von AdGuard Home in Home Assistant

Nachdem AdGuard Home eigenständig läuft, können Sie die offizielle Integration in Home Assistant hinzufügen, um Statistiken und grundlegende Kontrollfunktionen direkt im HA-Dashboard anzuzeigen.

4.1 Integration hinzufügen

1. Gehen Sie in Home Assistant zu Einstellungen > Geräte & Dienste.
2. Klicken Sie unten rechts auf INTEGRATION HINZUFÜGEN.
3. Suchen Sie nach AdGuard Home und wählen Sie es aus.
4. Geben Sie im Dialogfeld die folgenden Informationen ein:
   • Host: Die IP-Adresse Ihrer Home Assistant-Instanz (z.B. 192.168.1.100).
   • Port: Der Port Ihrer AdGuard Home Web-Oberfläche (standardmäßig 3000).
   • Benutzername: Der Administrator-Benutzername, den Sie in AdGuard Home festgelegt haben.
   • Passwort: Das entsprechende Passwort.
5. Klicken Sie auf Senden.
6. Wenn die Verbindung erfolgreich ist, werden Sie möglicherweise aufgefordert, den Bereich der Integration zu wählen (z.B. ein spezifischer Raum).
7. Nach Abschluss sollten Sie eine neue Kachel für AdGuard Home unter Geräte & Dienste sehen.

4.2 Sensoren und Entitäten in Home Assistant

Die Integration erstellt verschiedene Sensoren in Home Assistant, die Ihnen wichtige Informationen liefern:

• Anzahl der blockierten DNS-Anfragen.
• Gesamtzahl der DNS-Anfragen.
• Anzahl der aktiven Filterlisten.
• AdGuard Home Version.
• DNS-Schutzstatus (ein/aus).

Diese Sensoren können Sie in Ihren Dashboards (Lovelace) verwenden, um den Status Ihres Netzwerks auf einen Blick zu überwachen.

Schritt 5: Netzwerkgeräte zur Nutzung von AdGuard Home konfigurieren

Damit AdGuard Home seine Wirkung entfalten kann, müssen Ihre Geräte es als DNS-Server verwenden. Hierfür gibt es zwei Hauptmethoden:

5.1 Router-Konfiguration (Empfohlen für das gesamte Netzwerk)

Dies ist die effizienteste Methode, da alle Geräte, die sich mit Ihrem Router verbinden, automatisch AdGuard Home als DNS-Server nutzen. Die genauen Schritte variieren je nach Router-Modell:

1. Melden Sie sich in der Konfigurationsoberfläche Ihres Routers an (oft unter http://192.168.1.1 oder http://192.168.178.1 für Fritz!Box).
2. Suchen Sie nach den Einstellungen für DHCP oder DNS-Server. Diese befinden sich oft unter Internetzugang, Netzwerk oder LAN-Einstellungen.
3. Stellen Sie die primäre DNS-Server-Adresse auf die IP-Adresse Ihrer Home Assistant-Instanz ein (z.B. 192.168.1.100).
4. Optional können Sie als sekundären DNS-Server einen öffentlichen Server (z.B. 1.1.1.1) oder sogar die gleiche HA-IP noch einmal eintragen. Letzteres ist sicherer, falls HA ausfällt, würden Anfragen ins Leere laufen, anstatt zu einem anderen DNS zu wechseln und Werbung durchzulassen. Ein anderer öffentlicher DNS dient als Fallback, lässt aber Werbung durch.
5. Speichern Sie die Einstellungen und starten Sie Ihren Router neu, falls erforderlich.
6. Wichtiger Schritt: Starten Sie alle Ihre Netzwerkgeräte neu oder trennen Sie sie kurz vom WLAN/LAN, damit sie die neuen DNS-Einstellungen über DHCP erhalten.

5.2 Manuelle Konfiguration auf einzelnen Geräten

Wenn Sie nicht den gesamten Netzwerkverkehr über AdGuard Home leiten möchten oder Ihr Router die Einstellung nicht zulässt, können Sie DNS manuell auf einzelnen Geräten konfigurieren:

• Windows: Netzwerkeinstellungen > Adapteroptionen ändern > Eigenschaften des Adapters > Internetprotokoll Version 4 (TCP/IPv4) > Eigenschaften > Folgende DNS-Serveradressen verwenden.
• macOS: Systemeinstellungen > Netzwerk > Erweitert > DNS.
• Android/iOS: WLAN-Einstellungen > Netzwerkdetails/Netzwerk konfigurieren > DNS-Einstellungen (manuell/statisch).

Geben Sie hier ebenfalls die IP-Adresse Ihrer Home Assistant-Instanz als DNS-Server ein.

Schritt 6: Testen und Verifizieren

Nachdem alles konfiguriert ist, ist es Zeit zu prüfen, ob AdGuard Home wie erwartet funktioniert.

1. Besuchen Sie werbelastige Websites wie z.B. bestimmte Nachrichtenseiten oder Blogs. Sie sollten eine deutliche Reduzierung oder das vollständige Fehlen von Werbebannern feststellen.
2. Gehen Sie zum AdGuard Home Dashboard (http://[Ihre_HA_IP]:3000).
3. Überprüfen Sie den Anfrage-Statistiken und Top blockierte Domains-Bereich. Sie sollten sehen, dass Anfragen blockiert werden.
4. Im Abfrageprotokoll können Sie detailliert sehen, welche Anfragen von welchen Geräten gestellt wurden und ob sie blockiert oder erlaubt wurden.
5. In Home Assistant sollten die Sensoren der AdGuard Home Integration aktualisierte Werte anzeigen, insbesondere die Anzahl der blockierten Anfragen.

Erweiterte Tipps und Tricks

• Eigene Filterlisten: Sie können eigene Filterlisten hinzufügen, indem Sie einfach die URL einer öffentlichen Liste (z.B. eine regionale Werbeblockerliste) unter DNS-Filter > Filterliste hinzufügen > Eine benutzerdefinierte Liste hinzufügen eingeben.
• Benutzerdefinierte Filterregeln: Unter DNS-Filter > Benutzerdefinierte Filterregeln können Sie eigene Regeln hinzufügen, um spezifische Domains zu blockieren (||domain.com^) oder zu erlauben (@@||domain.com^).
• Client-Management: AdGuard Home kann Clients anhand ihrer IP-Adresse oder sogar ihres Hostnamens identifizieren. Unter Einstellungen > Client-Einstellungen können Sie diesen Clients individuelle Regeln oder Filterlisten zuweisen (z.B. für Kindersicherungen).
• DHCP-Server: AdGuard Home kann auch als DHCP-Server agieren. Dies ist eine fortgeschrittene Option, die es AdGuard Home ermöglicht, IP-Adressen an Ihre Geräte zu vergeben und gleichzeitig die DNS-Einstellungen zu kontrollieren. Seien Sie vorsichtig, wenn Sie dies aktivieren, und stellen Sie sicher, dass Ihr Router keinen eigenen DHCP-Server mehr betreibt, um Konflikte zu vermeiden.
• DNS über HTTPS/TLS (DoH/DoT): Für zusätzliche Privatsphäre können Sie Upstream-DNS-Server konfigurieren, die DNS-Anfragen verschlüsselt senden. Dies finden Sie unter Einstellungen > DNS-Einstellungen > Upstream-DNS-Server mit Optionen wie tls://dns.quad9.net oder https://cloudflare-dns.com/dns-query.

Fehlerbehebung bei häufigen Problemen

• Webseiten werden nicht geladen / Internet funktioniert nicht:
  • Überprüfen Sie, ob AdGuard Home läuft (Protokolle im Add-on und im AdGuard Home Dashboard).
  • Stellen Sie sicher, dass Ihre Router- oder Geräteeinstellungen die korrekte IP-Adresse von Home Assistant als DNS-Server verwenden.
  • Versuchen Sie temporär, die Filterlisten in AdGuard Home zu deaktivieren oder weniger restriktive Listen zu verwenden, um zu sehen, ob eine blockierte Domain das Problem verursacht.
  • Überprüfen Sie das Abfrageprotokoll in AdGuard Home, um zu sehen, welche Domains blockiert werden, wenn die Seite nicht lädt.
  • Löschen Sie den DNS-Cache auf Ihrem Gerät (ipconfig /flushdns unter Windows).
• Werbung wird immer noch angezeigt:
  • Stellen Sie sicher, dass Ihre Geräte tatsächlich AdGuard Home als DNS-Server nutzen (prüfen Sie die DNS-Einstellungen auf dem Gerät).
  • Überprüfen Sie, ob Sie ausreichend Filterlisten aktiviert haben.
  • Manche Werbung wird nicht über DNS blockiert, sondern ist direkt in die Website eingebettet oder verwendet Techniken, die DNS-Blocker umgehen (z.B. Same-Origin-Policy). Hier können Browser-Erweiterungen immer noch nützlich sein.
  • Manchmal müssen Sie den Browser-Cache leeren oder den Inkognito-Modus verwenden, um alte, zwischengespeicherte Werbung loszuwerden.
• Home Assistant Integration funktioniert nicht:
  • Stellen Sie sicher, dass AdGuard Home läuft und die Web-Oberfläche erreichbar ist.
  • Überprüfen Sie die eingegebenen Anmeldedaten (Benutzername und Passwort) und den Port in der HA-Integration.
  • Sehen Sie in den Home Assistant-Protokollen nach Fehlermeldungen.

Fazit

Die Integration von AdGuard Home in Home Assistant ist ein mächtiger Schritt, um die Kontrolle über Ihr Heimnetzwerk zu erlangen. Sie genießen ein werbefreies Surfen, schützen Ihre Privatsphäre vor Trackern und erhöhen die Sicherheit vor schädlichen Inhalten – alles von einer zentralen Plattform aus. Mit dieser Schritt-für-Schritt-Anleitung sollten Sie nun in der Lage sein, Ihre eigene, personalisierte Netzwerkfilterlösung zu betreiben und ein deutlich angenehmeres digitales Erlebnis für sich und Ihre Familie zu schaffen. Viel Erfolg beim werbefreien Surfen!