Ana içeriğe atla

Genel Bakış

What is AdGuard DNS CLI?​

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ıç​

Desteklenen işletim sistemleri:

  • Linux
  • macOS
  • Windows

Desteklenen CPU mimarileri:

  • 64 bit ARM
  • AMD64
  • i386

Başlarken​

Unix benzeri işletim sistemleri​

  1. .tar.gz or .zip arşivini sürümler sayfasından indirin ve açın.

    dikkat

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

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

    ./adguarddns-cli -s install -v

  3. config.yaml yapılandırma dosyasını düzenleyin.

  4. Hizmeti başlatın:

    ./adguarddns-cli -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 CLI print out a help message to standard output and exit with a success status-code.

Hizmet​

-s <value> seçeneği işletim sistemi hizmeti eylemini belirtir. Olası değerler:

  • install: installs AdGuard DNS CLI as a service
  • restart: restarts the running AdGuard DNS CLI service
  • start: starts the installed AdGuard DNS CLI service
  • status: shows the status of the installed AdGuard DNS CLI service
  • stop: stops the running AdGuard DNS CLI
  • uninstall: uninstalls AdGuard DNS CLI service

Verbose​

-v seçeneği ayrıntılı günlük çıktısını etkinleştirir.

Sürüm​

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

Yapılandırma​

Dosya​

YAML yapılandırma dosyası kendi makalesinde açıklanmıştır ve ayrıca config.dist.yaml örnek yapılandırma dosyası da bulunmaktadır. Bazı yapılandırma parametreleri ortam kullanılarak da geçersiz kılınabilir.

Çıkış kodları​

Farklı hata koşullarında görünebilecek birkaç farklı çıkış kodu vardır:

  • 0: Başarıyla tamamlandı ve çıkıldı, hata yok.

  • 1: Dâhili hata, büyük olasılıkla yanlış yapılandırma.

  • 2: Hatalı komut satırı argümanı veya değeri.