resolver_add

Директива resolver_add позволяет добавлять адреса DNS resolver в указанный набор в контексте модуля NGINX Proxy-Wasm.

Синтаксисresolver_add address resolver_name;
По умолчаниюnone
Контекстhttp, server, location
Аргументы2

Описание

Директива resolver_add является неотъемлемой частью модуля Proxy-Wasm для NGINX, особенно в сценариях, требующих динамического разрешения DNS. Эта директива позволяет сконфигурировать несколько адресов DNS resolver, которые используются WebAssembly-фильтрами во время их выполнения. Указывая эти resolver, вы обеспечиваете возможность для ваших WASM-модулей динамически разрешать имена хостов, что расширяет функциональность вашего HTTP-сервера или прокси.\n\nКаждый адрес resolver, добавленный с помощью resolver_add, будет использоваться в зависимости от контекста. Директива облегчает такие операции, как разрешение имён хостов для исходящих прокси-запросов или обработку клиентских запросов, которые вовлекают бэкенд-сервисы, идентифицируемые доменными именами. Такая гибкость особенно важна в современных архитектурах приложений, где микросервисы могут меняться динамически, и эффективное разрешение имён необходимо для принятия решений о маршрутизации или для коммуникации между сервисами.\n\nДиректива принимает два параметра: адрес resolver, обычно указанный в формате, допустимом для DNS-сервера (например, IP-адрес), и необязательный параметр, задающий допустимое имя resolver. Понимание того, как структурировать эти параметры, является ключом к правильной конфигурации и обеспечивает, чтобы ваши WebAssembly-модули могли эффективно разрешать необходимые адреса в фазах своей обработки.

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

http {
    resolver 8.8.8.8 valid=30s; 
    resolver_add 8.8.4.4 additional_resolver;
}

Убедитесь, что адреса resolver доступны серверу NGINX; в противном случае name resolution не будет работать.

Неправильная конфигурация DNS resolver names может привести к непредвиденному поведению при module resolutions WebAssembly.

Добавление resolver без предварительного указания primary resolver может привести к путанице в resolution priorities.

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