Spring til hovedindhold

Oversigt

Hvad er AdGuard DNS CLI?​

En krydsplatforms, letvægts DNS-klient til [AdGuard DNS][agdns]. Den fungerer som en DNS-server, der videresender DNS-forespørgsler til de korresponderende upstream-opløsere.

Hurtigstart​

Understøttede operativsystemer:

  • Linux
  • macOS
  • Windows

Understøttede CPU-arkitekturer:

  • 64-bit ARM
  • AMD64
  • i386

Komme i gang​

UNIX-agtig operativsystemer​

  1. Download og udpak .tar.gz- eller .zip-arkivet fra udgivelsessiden.

    advarsel

    På macOS er det afgørende, at globalt installerede daemons ejes af root (se [launchd-dokumentationen][launchd-krav]), så den eksekverbare adguarddns-cli skal placeres i mappen /Applications/ eller dens undermappe.

  2. Installér den som en tjeneste ved at eksekvere:

    ./adguarddns-cli -s install -v

  3. Redigér opsætningsfilen config.yaml.

  4. Start tjenesten:

    ./adguarddns-cli -s start -v

For at tjekke, at det virker, brug et hvilket som helst DNS-kontrolværktøj. F.eks. ved at bruge nslookup:

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

Windows​

Download og installér blot vha. MSI-installationsprogrammet fra udgivelsessiden.

For at tjekke, at det virker, brug et hvilket som helst DNS-kontrolværktøj. F.eks. ved at bruge nslookup.exe:

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

Kommandolinjemuligheder​

Hver valgmulighed tilsidesætter den korresponderende værdi fra opsætningsfilen og miljøet.

Hjælp​

Valgmulighed -h får AdGuard DNS CLI til at udskrive en hjælpemeddelelse til standardoutput og afslutte med en udført-statuskode.

Tjeneste​

Mulighed -s <value> angiver OS-tjenestehandlingen. Gyldige værdier er:

  • install: Installerer AdGuard DNS CLI som en tjeneste
  • restart: Genstarter den kørende AdGuard DNS CLI-tjeneste
  • start: Starter den installerede AdGuard DNS CLI-tjeneste
  • status: Viser statussen på den installerede AdGuard DNS CLI-tjeneste
  • stop: Stopper den kørende AdGuard DNS CLI
  • uninstall: Afinstallerer AdGuard DNS CLI-tjenesten

Udførlig​

Valgmulighed -v aktiverer det udførlige logoutput.

Version​

Valgmuligheden --version får AdGuard DNS CLI til at udskrive versionen på applikationen til standardoutput og afslutte med en udført-statuskode.

Opsætning​

Fil​

YAML-opsætningsfilen er beskrevet i sin egen artikel, og der findes også en eksempel-opsætningsfil config.dist.yaml. Visse opsætningsparametre kan også tilsidesættes vha. environment.

Afslutningskoder​

Der er et nogle forskellige afslutningskoder, som kan vises under forskellige fejltilstande:

  • 0: Fuldført og afsluttet, ingen fejl.

  • 1: Intern fejl, højst sandsynligt en fejlopsætning.

  • 2: Forkert kommandolinjeargument eller -værdi.