Ana içeriğe atla

Genel Bakış

AdGuard DNS İstemcisi nedir?

A cross-platform lightweight DNS client for AdGuard DNS. It operates as a DNS server that forwards DNS requests to the corresponding upstream resolvers.

Hızlı başlangıç

dikkat

AdGuard DNS İstemcisi hâlâ Beta aşamasındadır. Kararsız olabilir.

Desteklenen işletim sistemleri:

  • Linux
  • macOS
  • Windows

Desteklenen CPU mimarileri:

  • 64 bit ARM
  • AMD64
  • i386

Başlarken

Unix benzeri işletim sistemleri

  1. Download and unpack the .tar.gz or .zip archive from the releases page.

    :::dikkat

    On macOS, it's crucial that globally installed daemons are owned by root (see the launchd documentation), so the AdGuardDNSClient executable must be placed in the /Applications/ directory or its subdirectory.

    :::

  2. Çalıştırarak bir hizmet olarak yükleyin:

    ./AdGuardDNSClient -s install -v
  3. config.yaml yapılandırma dosyasını düzenleyin.

  4. Hizmeti başlatın:

    ./AdGuardDNSClient -s start -v

Çalıştığını kontrol etmek için herhangi bir DNS kontrol yardımcı programını kullanın. Örneğin, nslookup kullanarak:

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

Windows

Sadece sürümler sayfasından MSI yükleyicisini kullanarak indirin ve kurun.

Çalıştığını kontrol etmek için herhangi bir DNS kontrol yardımcı programını kullanın. Örneğin, nslookup.exe kullanarak:

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

Komut satırı seçenekleri

Her seçenek, yapılandırma dosyası ve çevre tarafından sağlanan ilgili değeri geçersiz kılar.

Yardım

Option -h makes AdGuard DNS Client print out a help message to standard output and exit with a success status-code.

Service

Option -s <value> specifies the OS service action. Olası değerler:

  • install: installs AdGuard DNS Client as a service
  • restart: çalışan AdGuard DNS İstemcisi hizmetini yeniden başlatır
  • start: starts the installed AdGuard DNS Client service
  • status: kurulu AdGuard DNS İstemcisi hizmetinin durumunu gösterir
  • stop: çalışan AdGuard DNS İstemcisini durdurur
  • uninstall: AdGuard DNS İstemcisi hizmetini kaldırır

Verbose

Option -v enables the verbose log output.

Version

Option --version makes AdGuard DNS Client print out the version of the AdGuardDNSClient executable to standard output and exit with a success status-code.

Configuration

File

The YAML configuration file is described in its own article, and there is also a sample configuration file config.dist.yaml. Some configuration parameters can also be overridden using the environment.

Exit codes

There are a few different exit codes that may appear under different error conditions:

  • 0: Successfully finished and exited, no errors.

  • 1: Internal error, most likely a misconfiguration.

  • 2: Bad command-line argument or value.