Перейти к основному содержанию

Обзор

Что такое AdGuard DNS Client?​

Кроссплатформенный облегчённый DNS-клиент для AdGuard DNS. Он работает как DNS-сервер, перенаправляющий DNS-запросы соответствующим upstream-резолверам.

Быстрый старт​

caution

AdGuard DNS Client всё ещё находится в стадии бета-тестирования. Он может быть нестабильным.

Поддерживаемые операционные системы:

  • Linux
  • macOS
  • Windows

Поддерживаемые архитектуры процессоров:

  • 64-разрядный ARM
  • AMD64
  • i386

Начало работы​

Unix-подобные операционные системы​

  1. Скачайте и распакуйте архив .tar.gz или .zip со страницы релизов.

    caution

    На macOS очень важно, чтобы глобально установленные демоны принадлежали root (см. документацию launchd), поэтому исполняемый файл AdGuardDNSClient должен быть помещён в директорию /Applications/ или её поддиректорию.

  2. Установите его как службу, выполнив:

    ./AdGuardDNSClient -s install -v

  3. Отредактируйте файл конфигурации config.yaml.

  4. Запустите службу:

    ./AdGuardDNSClient -s start -v

Чтобы убедиться, что он работает, используйте любую утилиту проверки DNS. Например, с помощью nslookup:

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

Windows​

Просто скачайте и установите с помощью установщика MSI со страницы релизы.

Чтобы убедиться, что он работает, используйте любую утилиту проверки DNS. Например, с помощью nslookup.exe:

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

Параметры командной строки​

Каждый параметр переопределяет соответствующее значение, предоставленное файлом конфигурации и средой.

Справка​

Опция -h заставляет AdGuard DNS Client выводить справочное сообщение на стандартный вывод и завершать работу с кодом успешного выполнения.

Сервис​

Параметр -s <value> определяет действие службы ОС. Возможные значения:

  • install: устанавливает AdGuard DNS Client в качестве службы
  • restart: перезапускает запущенную службу AdGuard DNS Client
  • start: запускает установленную службу AdGuard DNS Client
  • status: показывает статус установленной службы AdGuard DNS Client
  • stop: останавливает запущенный AdGuard DNS Client
  • uninstall: удаляет службу AdGuard DNS Client

Подробно​

Параметр -v включает подробный вывод логов.

Версия​

Параметр --version заставляет AdGuard DNS Client выводить стандартную версию исполняемого файла AdGuardDNSClient и завершать работу с кодом успешного завершения.

Конфигурация​

Файл​

Конфигурационный файл YAML описан в отдельной статье, там же есть пример конфигурационного файла config.dist.yaml. Некоторые параметры конфигурации также можно переопределить с помощью среды.

Коды выхода​

Существует несколько кодов выхода, которые могут появляться при различных условиях ошибки:

  • 0: успешное завершение и выход, ошибок нет.

  • 1: внутренняя ошибка, скорее всего, неправильная конфигурация.

  • 2: неверный аргумент или значение командной строки.