Zum Hauptinhalt springen

Erste Schritte

Installation​

Offizielle Veröffentlichungen​

Laden Sie das Archiv mit der Binärdatei für Ihr Betriebssystem von der [Seite der letzten stabilen Version][Veröffentlichungen] herunter. Die vollständige Liste der unterstützten Plattformen sowie Links zu Beta- und Edge-Versionen (instabilen Versionen) finden Sie auf [unserer Plattformseite][Plattformen].

Um AdGuard Home als Dienst zu installieren, entpacken Sie das Archiv, geben Sie das Verzeichnis „AdGuardHome“ an und führen Sie es aus:

./AdGuardHome -s install

Hinweise​

  • Benutzer von Fedora Linux und dessen Derivaten: Installieren Sie AdGuard Home in das Verzeichnis „/usr/local/bin“. Andernfalls kann es zu Problemen mit SELinux und Berechtigungen kommen. Siehe [Problem 765] und [Problem 3281].

  • Benutzer von macOS 10.15 Catalina und neuer sollten das Arbeitsverzeichnis von AdGuard Home in das Verzeichnis „/Applications“ (Programme) legen.

Docker und Snap​

Wir bieten auch ein offizielles AdGuard Home Docker-Image und ein offizielles Snap Store-Paket für erfahrene Benutzer.

Sonstiges​

Einige andere inoffizielle Optionen sind:

Erster Start​

Überprüfen Sie zunächst Ihre Firewall-Einstellungen. Um AdGuard Home zu installieren und zu verwenden, müssen die folgenden Ports und Protokolle verfügbar sein:

  • 3000/TCP für die Erstinstallation;
  • 80/TCP für die Webschnittstelle;
  • 53/UDP für den DNS-Server.

Möglicherweise müssen Sie zusätzliche Ports für andere Protokolle als reines DNS öffnen, z. B. für DNS-over-HTTPS.

DNS-Server binden sich an Port 53, wofür meistens Superuser-Rechte erforderlich sind [siehe unten] (#running-without-superuser). Daher müssen Sie es auf Unix-Systemen mit sudo oder doas im Terminal ausführen:

sudo ./AdGuardHome

Starten Sie unter Windows cmd.exe oder PowerShell mit Administratorrechten und führen Sie AdGuardHome.exe aus.

Wenn Sie AdGuard Home zum ersten Mal starten, beginnt es mit der Überwachung von 0.0.0.0:3000 und fordert Sie auf, es in Ihrem Browser zu öffnen:

AdGuard Home ist unter den folgenden Adressen erhältlich:
unter http://127.0.0.1:3000
unter http://[::1]:3000
[…]

Dort werden Sie durch den Assistenten für die Erstkonfiguration geführt.

Bildschirm zur Auswahl der Netzwerkschnittstelle von AdGuard Home

Bildschirm zum Anlegen eines AdGuard Home-Benutzers

In unserem Artikel zum sicheren Betrieb von AdGuard Home finden Sie eine Anleitung, wie Sie die für Sie am besten geeignete Ausgangskonfiguration auswählen.

Als Dienst ausgeführt​

Der nächste Schritt wäre die Registrierung von AdGuard Home als Systemdienst (auch Daemon genannt). Um AdGuard Home als Dienst zu installieren, führen Sie Folgendes aus:

sudo ./AdGuardHome -s install

Starten Sie unter Windows cmd.exe mit Administratorrechten und führen Sie AdGuardHome.exe -s install aus, um einen Windows-Dienst zu registrieren.

Hier sind die anderen Befehle, die Sie zum Steuern des Dienstes benötigen:

  • AdGuardHome -s uninstall: Deinstalliert den Dienst AdGuard Home.
  • AdGuardHome -s start: Startet den Dienst.
  • AdGuardHome -s stop: Stoppt den Dienst.
  • AdGuardHome -s start: Startet den Dienst neu.
  • AdGuardHome -s status: Zeigt den aktuellen Dienststatus an.

Protokolle​

Standardmäßig werden die Protokolle nach stderr geschrieben, wenn Sie AdGuard Home in einem Terminal ausführen. Wenn Sie es als Dienst ausführen, hängt die Protokollausgabe von der Plattform ab:

  • Unter macOS wird das Protokoll in die Dateien /var/log/AdGuardHome.*.log geschrieben.

  • Auf anderen Unixen wird das Protokoll in syslog oder journald geschrieben.

  • Unter Windows wird das Protokoll in das Windows-Ereignisprotokoll geschrieben.

Sie können dieses Verhalten in der AdGuard Home Konfigurationsdatei ändern.

Aktualisieren​

Ein Beispiel für eine Aktualisierungsmeldung

Wenn eine neue Version veröffentlicht wird, zeigt die Benutzeroberfläche von AdGuard Home eine Benachrichtigung und die Schaltfläche Jetzt aktualisieren an. Klicken Sie auf diese Schaltfläche, und AdGuard Home wird automatisch auf die neueste Version aktualisiert. Ihre aktuelle ausführbare Datei von AdGuard Home wird zusammen mit der aktuellen Konfigurationsdatei im Verzeichnis Backup gespeichert, so dass Sie die Änderungen bei Bedarf widerrufen können.

Manuelles Aktualisieren​

Falls die Schaltfläche nicht angezeigt wird oder eine automatische Aktualisierung fehlgeschlagen ist, können Sie die Aktualisierung manuell vornehmen. Wir haben einen ausführlichen Leitfaden für die manuelle Aktualisierung, aber kurz gefasst:

  1. Laden Sie das neue AdGuard Home-Paket herunter.

  2. Entpacken Sie sie in einen temporären Ordner.

  3. Ersetzen Sie die alte ausführbare Datei von AdGuard Home durch die neue.

  4. Starten Sie AdGuard Home neu.

Aktualisierungen für Docker, Home Assistant und Snapcraft​

Automatische Aktualisierungen für Docker, Hass.io/Home Assistant und Snapcraft-Installationen sind deaktiviert. Aktualisieren Sie stattdessen das Image.

Aktualisierung über die Befehlszeile​

Um das AdGuard Home-Paket zu aktualisieren, ohne die Web-API verwenden zu müssen, führen Sie folgenden Befehl aus:

./AdGuardHome --update

Geräte konfigurieren​

Router​

Diese Einrichtung deckt automatisch alle Geräte ab, die mit Ihrem Heimrouter verbunden sind, und Sie müssen nicht jedes einzelne Gerät manuell konfigurieren.

  1. Öffnen Sie die Einstellungen für Ihren Router. Normalerweise können Sie von Ihrem Browser aus über eine URL wie http://192.168.0.1/ oder http://192.168.1.1/ darauf zugreifen. Möglicherweise werden Sie aufgefordert, ein Passwort einzugeben. Wenn Sie sich nicht mehr daran erinnern, können Sie das Kennwort oft durch Drücken einer Taste am Router selbst zurücksetzen. Beachten Sie jedoch, dass Sie bei dieser Vorgehensweise wahrscheinlich die gesamte Routerkonfiguration verlieren. Wenn für die Einrichtung Ihres Routers eine App erforderlich ist, installieren Sie diese bitte auf Ihrem Telefon oder PC und verwenden Sie sie für den Zugriff auf die Einstellungen des Routers.

  2. Suchen Sie die DHCP/DNS-Einstellungen. Achten Sie auf die DNS-Buchstaben neben einem Feld, das zwei oder drei Zahlengruppen zulässt, die jeweils in vier Gruppen von ein bis drei Ziffern unterteilt sind.

  3. Tragen Sie dort Ihre AdGuard Home Server-Adressen ein.

  4. Bei einigen Routertypen kann kein benutzerdefinierter DNS-Server eingerichtet werden. In diesem Fall kann es hilfreich sein, AdGuard Home als DHCP-Server einzurichten. Andernfalls sollten Sie im Handbuch Ihres Routers nachlesen, wie Sie die DNS-Server für Ihr spezielles Routermodell anpassen können.

Windows​

  1. Öffnen Sie die Systemsteuerung über das Startmenü oder die Windows-Suche.

  2. Öffnen Sie Netzwerk und Internet und dann Netzwerk- und Freigabecenter.

  3. Suchen Sie auf der linken Seite des Bildschirms die Schaltfläche Adaptereinstellungen ändern und klicken Sie darauf.

  4. Wählen Sie Ihre aktive Verbindung aus, klicken Sie mit der rechten Maustaste darauf und wählen Sie Eigenschaften.

  5. Suchen Sie Internet Protocol Version 4 (TCP/IPv4) (oder, für IPv6, Internet Protocol Version 6 (TCP/IPv6)) in der Liste, wählen Sie es aus und klicken Sie erneut auf Eigenschaften.

  6. Wählen Sie Folgende DNS-Serveradressen verwenden und geben Sie die Adressen Ihrer AdGuard Home-Server ein.

macOS​

  1. Klicken Sie auf das Apple-Symbol und gehen Sie zu Systemeinstellungen.

  2. Klicken Sie auf Netzwerk.

  3. Wählen Sie die erste Verbindung in Ihrer Liste aus und klicken Sie auf Weitere Optionen.

  4. Wählen Sie den Tab „DNS“ und geben Sie die Adressen Ihrer AdGuard Home-Server ein.

Android​

note

Die Anweisungen für Android-Geräte können sich je nach Betriebssystemversion und Hersteller unterscheiden.

  1. Tippen Sie auf dem Startbildschirm des Android-Menüs auf Einstellungen.

  2. Tippen Sie im Menü auf Wi-Fi. Der Bildschirm mit allen verfügbaren Netzwerken wird angezeigt (es ist nicht möglich, benutzerdefiniertes DNS für die mobile Verbindung festzulegen).

  3. Drücken Sie lange auf das Netzwerk, mit dem Sie verbunden sind, und tippen Sie auf Netzwerk ändern.

  4. Auf einigen Geräten müssen Sie möglicherweise das Kontrollkästchen Erweitert aktivieren, um weitere Einstellungen anzuzeigen. Um Ihre Android-DNS-Einstellungen anzupassen, müssen Sie die IP-Einstellungen von DHCP auf Statisch ändern.

  5. Ändern Sie die Werte für „DNS 1” und „DNS 2” auf Ihre AdGuard Home-Serveradressen.

iOS​

  1. Tippen Sie auf dem Startbildschirm auf Einstellungen.

  2. Wählen Sie WLAN aus dem linken Menü (es ist nicht möglich, DNS für mobile Netzwerke zu konfigurieren).

  3. Tippen Sie auf den Namen des aktuell aktiven Netzwerks.

  4. Geben Sie im Bereich DNS die Adressen Ihrer AdGuard Home-Server ein.

Ausführen ohne Superuser​

Sie können AdGuard Home auch ohne Superuser-Rechte ausführen, aber Sie müssen der Binärdatei entweder eine Fähigkeit verleihen (unter Linux) oder sie anweisen, einen anderen Port zu verwenden (alle Plattformen).

Gewährung der erforderlichen Fähigkeiten (nur Linux)​

Die Verwendung dieser Methode erfordert das Dienstprogramm setcap. Möglicherweise müssen Sie es über den Paketmanager Ihrer Linux-Distribution installieren.

Um AdGuard Home unter Linux zu erlauben, den Port 53 ohne Superuser-Rechte zu überwachen und seine DNS-Server an eine bestimmte Schnittstelle zu binden, führen Sie folgenden Befehl aus:

sudo setcap 'CAP_NET_BIND_SERVICE=+eip CAP_NET_RAW=+eip' ./AdGuardHome

Führen Sie dann ./AdGuardHome als unprivilegierter Benutzer aus.

Ändern des DNS-Abhörports​

Um AdGuard Home so zu konfigurieren, dass es an einem Port lauscht, der keine Superuser-Rechte erfordert, stoppen Sie AdGuard Home, öffnen Sie AdGuardHome.yaml in Ihrem Editor oder im Terminal per sudo nano /weg/zum/AdGuardHome.yaml und suchen Sie diese Zeilen:

dns:
    # …
    port: 53

Sie können den Port auf einen Wert über 1024 ändern, um zu vermeiden, dass Sie Superuser-Rechte benötigen.

Einschränkungen​

Einige Dateisysteme unterstützen den vom Statistiksystem benötigten mmap(2)-Systemaufruf nicht. Siehe auch [Problem 1188].

Sie können dieses Problem beheben:

  • Entweder durch Angabe der Argumente --work-dir DIRECTORY an das AdGuardHome-Binary. Diese Option weist AGH an, ein anderes Verzeichnis für alle seine Dateien zu verwenden, anstatt des Standardverzeichnisses ./data.

  • Oder indem Sie symbolische Links erstellen, die auf ein anderes Dateisystem zeigen, das mmap(2) unterstützt (z.B. tmpfs):

    ln -s ${YOUR_AGH_PATH}/data/stats.db /tmp/stats.db
    ln -s ${YOUR_AGH_PATH}/data/sessions.db /tmp/sessions.db