Zum Hauptinhalt springen

Ü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. It may be unstable.

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.