Přejít k hlavnímu obsahu

Přehled

Co je AdGuard DNS Client?

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í

pozor

AdGuard DNS Client je stále ve fázi beta. Může být nestabilní.

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 AdGuardDNSClient musí být umístěn v adresáři /Applications/ nebo jeho podadresář.

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

    ./AdGuardDNSClient -s install -v
  3. Upravte konfigurační soubor config.yaml.

  4. Spusťte službu:

    ./AdGuardDNSClient -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 Client 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 Client jako službu
  • restart: restartuje běžící službu AdGuard DNS Client
  • start: spustí nainstalovanou službu AdGuard DNS Client
  • status: zobrazí stav nainstalované služby AdGuard DNS Client
  • stop: ukončí spuštěný AdGuard DNS Client
  • uninstall: odinstaluje službu AdGuard DNS Client

Verbose

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

Verze

Možnost --version způsobí, že AdGuard DNS Client vypíše verzi spustitelného souboru AdGuardDNSClient 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.