Überblick

Was ist AdGuard DNS Client?

Ein plattformübergreifender, schlanker DNS-Client für AdGuard DNS. Er fungiert als DNS-Server, der DNS-Anfragen an die entsprechenden vorgelagerten Resolver weiterleitet.

Schnellstart

caution

AdGuard DNS Client befindet sich noch im Beta-Stadium. Es könnte instabil sein.

Unterstützte Betriebssysteme:

• Linux
• macOS
• Windows

Unterstützte CPU-Architekturen:

• 64-bit ARM
• AMD64
• i386

Erste Schritte

Unix-ähnliche Betriebssysteme

1. Laden Sie das .tar.gz- oder .zip-Archiv von der Seite für Veröffentlichungen herunter und entpacken Sie es.

   caution

   Unter macOS ist es wichtig, dass global installierte Daemons root gehören (siehe die launchd-Dokumentation) (engl.), daher muss die ausführbare Datei AdGuardDNSClient im Verzeichnis /Applications/ oder dessen Unterverzeichnis abgelegt werden.

2. Installieren Sie ihn als Dienst, indem Sie Folgendes ausführen:

   ./AdGuardDNSClient -s install -v

3. Bearbeiten Sie die Konfigurationsdatei config.yaml.

4. Starten Sie den Dienst:

   ./AdGuardDNSClient -s start -v

Um zu überprüfen, ob es funktioniert, verwenden Sie ein beliebiges DNS-Prüfprogramm. Zum Beispiel unter Verwendung von nslookup:

nslookup -debug 'www.example.com' '127.0.0.1'

Windows

Laden Sie einfach das MSI-Installationsprogramm von der Seite für Veröffentlichungen herunter und installieren Sie es.

Um zu überprüfen, ob es funktioniert, verwenden Sie ein beliebiges DNS-Prüfprogramm. Zum Beispiel mit nslookup.exe:

nslookup -debug "www.example.com" "127.0.0.1"

Kommandozeilenoptionen

Jede Option überschreibt den entsprechenden Wert, der in der Konfigurationsdatei und der Umgebung angegeben ist.

Hilfe

Die Option -h bewirkt, dass AdGuard DNS Client eine Hilfemeldung auf der Standardausgabe ausgibt und mit einem Erfolgsstatuscode beendet wird.

Dienst

Die Option -s <value> gibt die Aktion des Betriebssystemdienstes an. Mögliche Werte sind:

• install: installiert den AdGuard DNS Client als Dienst
• restart: startet den laufenden Dienst AdGuard DNS Client neu
• start: startet den installierten Dienst AdGuard DNS Client
• status: zeigt den Status des installierten AdGuard DNS Client Dienstes
• stop: beendet den laufenden AdGuard DNS Client
• uninstall: deinstalliert den Dienst AdGuard DNS Client

Ausführlich

Die Option -v aktiviert die ausführliche Protokollausgabe.

Version

Die Option --version bewirkt, dass AdGuard DNS Client die Version der ausführbaren Datei AdGuardDNSClient auf der Standardausgabe ausgibt und mit einem Erfolgsstatuscode beendet wird.

Konfiguration

Datei

Die YAML-Konfigurationsdatei wird in eigenem Artikel beschrieben, und es gibt auch eine Beispielkonfigurationsdatei config.dist.yaml. Einige Konfigurationsparameter können auch mit der Option environment überschrieben werden.

Beendigungscodes

Es gibt einige verschiedene Beendigungscodes, die unter verschiedenen Fehlerbedingungen auftreten können:

• 0: Erfolgreich abgeschlossen und beendet, keine Fehler.

• 1: Interner Fehler, höchstwahrscheinlich eine Fehlkonfiguration.

• 2: Falsches Kommandozeilenargument oder falscher Wert.