Mercurial > hg > nginx-site
diff xml/ru/docs/mail/ngx_mail_core_module.xml @ 1068:0c5f8630fe40
Documented the mail "resolver" directive.
author | Sergey Kandaurov <pluknet@nginx.com> |
---|---|
date | Sat, 08 Feb 2014 17:42:41 +0400 |
parents | 8d9578f8523b |
children | 71e6daffa4dc |
line wrap: on
line diff
--- a/xml/ru/docs/mail/ngx_mail_core_module.xml +++ b/xml/ru/docs/mail/ngx_mail_core_module.xml @@ -182,6 +182,70 @@ listen unix:/var/run/nginx.sock; </directive> +<directive name="resolver"> +<syntax> +<value>адрес</value> ... +[<literal>valid</literal>=<value>время</value>]</syntax> +<syntax><literal>off</literal></syntax> +<default>off</default> +<context>mail</context> +<context>server</context> + +<para> +Задаёт серверы DNS, используемые для определения имени хоста клиента +для передачи его на +<link doc="ngx_mail_auth_http_module.xml">сервер аутентификации</link> +и в команде +<link doc="ngx_mail_proxy_module.xml" id="xclient">XCLIENT</link> +при проксировании SMTP. +Например: +<example> +resolver 127.0.0.1 [::1]:5353; +</example> +Адрес может быть указан в виде доменного имени или IP-адреса, +и необязательного порта (1.3.1, 1.2.2). +Если порт не указан, используется порт 53. +Серверы DNS опрашиваются циклически. +<note> +До версии 1.1.7 можно было задать лишь один DNS-сервер. +Задание DNS-серверов с помощью IPv6-адресов поддерживается +начиная с версий 1.3.1 и 1.2.2. +</note> +По умолчанию nginx кэширует ответы, используя значение TTL из ответа. +Необязательный параметр <literal>valid</literal> позволяет это +переопределить: +<example> +resolver 127.0.0.1 [::1]:5353 valid=30s; +</example> +<note> +До версии 1.1.9 настройка времени кэширования была невозможна +и nginx всегда кэшировал ответы на срок в 5 минут. +</note> +</para> + +<para> +Специальное значение <literal>off</literal> запрещает использование DNS. +</para> + +</directive> + + +<directive name="resolver_timeout"> +<syntax><value>время</value></syntax> +<default>30s</default> +<context>mail</context> +<context>server</context> + +<para> +Задаёт таймаут для операций DNS, например: +<example> +resolver_timeout 5s; +</example> +</para> + +</directive> + + <directive name="server"> <syntax block="yes"/> <default/>