doh_address

Директива `doh_address` задаёт адрес upstream DNS server для обработки запросов DNS-over-HTTPS в NGINX.

Синтаксисdoh_address address;
По умолчанию127.0.0.1
Контекстlocation
Аргументы1

Описание

Директива doh_address является частью модуля NGINX, специально разработанного для обслуживания запросов DNS-over-HTTPS (DOH). Когда эта директива используется внутри location block, она указывает адрес upstream DNS server, который NGINX будет использовать для разрешения DNS-запросов. Адрес может быть IPv4 или IPv6, что даёт гибкость конфигурации в зависимости от сетевой топологии и доступности DNS-резолверов. Эта директива критически важна для того, чтобы все DNS-запросы перенаправлялись на корректный upstream server, который обработает запрос и вернёт ответ.

Вместе с doh_port и doh_timeout директива doh_address помогает создать эффективный канал связи с DNS server. Если doh_address явно не определена, NGINX по умолчанию использует '127.0.0.1', что относится к локально запущенному DNS-серверу. Убедиться, что установлен правильный адрес, важно для корректной работы DNS-службы, поскольку любая неверная конфигурация может привести к сбоям в обработке DNS-запросов и возможным перебоям в работе сервиса.

При вызове директивы doh_address сервер NGINX отправляет DNS-запросы на указанный адрес при обработке входящих HTTP-запросов на разрешение DNS. Поведение можно отслеживать через корректное логирование входящих запросов и проверку того, что система способна эффективно обрабатывать DOH-трафик с заданными параметрами.

Пример конфига

location /dns-query {
    doh;
    doh_address 127.0.2.1;
}

Убедитесь, что адрес DNS-сервера доступен и правильно настроен.

Будьте осторожны с брандмауэрами, блокирующими трафик к указанному адресу DNS-сервера.

Использование неверного формата адреса приведёт к ошибкам конфигурации.

← Ко всем директивам