Обзор

Что такое AdGuard DNS CLI?

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

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

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

• Linux
• macOS
• Windows

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

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

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

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

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

   caution

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

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

   ./adguarddns-cli -s install -v

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

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

   ./adguarddns-cli -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 CLI выводить справочное сообщение на стандартный вывод и завершать работу с кодом успешного выполнения.

Сервис

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

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

Подробно

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

Версия

Параметр --version заставляет AdGuard DNS CLI вывести версию приложения в стандартный вывод (standard output) и завершить работу с кодом успешного завершения.

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

Файл

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

Коды выхода

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

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

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

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