Überblick

Was ist AdGuard DNS CLI?

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

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

   Auf macOS ist es entscheidend, dass global installierte Daemons von root gehört (siehe launchd-Dokumentation), daher muss die ausführbare Datei adguarddns-cli im Verzeichnis /Applications/ oder dessen Unterverzeichnis platziert werden.

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

   ./adguarddns-cli -s install -v

3. Bearbeiten Sie die Konfigurationsdatei config.yaml.

4. Starten Sie den Dienst:

   ./adguarddns-cli -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 CLI 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 CLI als Dienst
• restart: startet den laufenden Dienst AdGuard DNS CLI neu
• start: startet den installierten Dienst AdGuard DNS CLI
• status: zeigt den Status des installierten Dienstes AdGuard DNS CLI
• stop: beendet den laufenden AdGuard DNS CLI
• uninstall: deinstalliert den Dienst AdGuard DNS CLI

Ausführlich

Die Option -v aktiviert die ausführliche Protokollausgabe.

Version

Die Option --version veranlasst AdGuard DNS CLI, die Version der Anwendung auf der Standardausgabe auszugeben und mit einem Erfolgsstatuscode zu beenden.

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.