Přehled

Co je AdGuard DNS CLI?

Lehký multiplatformní klient DNS pro AdGuard DNS. Funguje jako DNS server, který předává požadavky DNS odpovídajícím odchozím řešitelům.

Rychlé spuštění

Podporované operační systémy:

• Linux
• macOS
• Windows

Podporované architektury CPU:

• 64-bit ARM
• AMD64
• i386

Začínáme

Operační systémy podobné Unixu

1. Stáhněte a rozbalte archiv .tar.gz nebo .zip ze stránky vydání.

   pozor

   V macOS je zásadní, aby globálně nainstalované démony vlastnil root (viz dokumentace launchd), takže spustitelný soubor adguarddns-cli musí být umístěn v adresáři /Applications/ nebo jeho podadresář.

2. Nainstalujte jej jako službu spuštěním:

   ./adguarddns-cli -s install -v

3. Upravte konfigurační soubor config.yaml.

4. Spusťte službu:

   ./adguarddns-cli -s start -v

Chcete-li zkontrolovat, zda funguje, použijte libovolný nástroj pro kontrolu DNS. Například pomocí nslookup:

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

Windows

Stačí stáhnout a nainstalovat pomocí instalačního programu MSI ze stránky vydání.

Chcete-li zkontrolovat, zda funguje, použijte libovolný nástroj pro kontrolu DNS. Například pomocí nslookup.exe:

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

Možnosti příkazového řádku

Každá volba přepíše odpovídající hodnotu uvedenou v konfiguračním souboru a prostředí.

Nápověda

Možnost -h způsobí, že AdGuard DNS CLI vytiskne zprávu nápovědy na standardní výstup a ukončí se s kódem stavu úspěchu.

Služba

Možnost -s <value> určuje akci služby operačního systému. Přípustné hodnoty jsou:

• install: nainstaluje AdGuard DNS CLI jako službu
• restart: restartuje běžící službu AdGuard DNS CLI
• start: spustí nainstalovanou službu AdGuard DNS CLI
• status: zobrazí stav nainstalované služby AdGuard DNS CLI
• stop: ukončí spuštěný AdGuard DNS CLI
• uninstall: odinstaluje službu AdGuard DNS CLI

Verbose

Možnost -v umožňuje podrobný výstup protokolu.

Verze

Možnost --version způsobí, že AdGuard DNS CLI vypíše verzi aplikace na standardní výstup a ukončí se stavovým kódem úspěchu.

Konfigurace

Soubor

Konfigurační soubor YAML je popsán ve vlastním článku a k dispozici je také ukázkový konfigurační soubor config.dist.yaml. Některé konfigurační parametry lze také nadefinovat pomocí příkazu environment.

Výstupní kódy

Existuje několik různých kódů ukončení, které se mohou objevit při různých chybových stavech:

• 0: Úspěšně dokončeno a ukončeno, žádné chyby.

• 1: Interní chyba, pravděpodobně chybná konfigurace.

• 2: Chybný argument nebo hodnota příkazového řádku.