comparison 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
comparison
equal deleted inserted replaced
1067:8d9578f8523b 1068:0c5f8630fe40
180 </para> 180 </para>
181 181
182 </directive> 182 </directive>
183 183
184 184
185 <directive name="resolver">
186 <syntax>
187 <value>адрес</value> ...
188 [<literal>valid</literal>=<value>время</value>]</syntax>
189 <syntax><literal>off</literal></syntax>
190 <default>off</default>
191 <context>mail</context>
192 <context>server</context>
193
194 <para>
195 Задаёт серверы DNS, используемые для определения имени хоста клиента
196 для передачи его на
197 <link doc="ngx_mail_auth_http_module.xml">сервер аутентификации</link>
198 и в команде
199 <link doc="ngx_mail_proxy_module.xml" id="xclient">XCLIENT</link>
200 при проксировании SMTP.
201 Например:
202 <example>
203 resolver 127.0.0.1 [::1]:5353;
204 </example>
205 Адрес может быть указан в виде доменного имени или IP-адреса,
206 и необязательного порта (1.3.1, 1.2.2).
207 Если порт не указан, используется порт 53.
208 Серверы DNS опрашиваются циклически.
209 <note>
210 До версии 1.1.7 можно было задать лишь один DNS-сервер.
211 Задание DNS-серверов с помощью IPv6-адресов поддерживается
212 начиная с версий 1.3.1 и 1.2.2.
213 </note>
214 По умолчанию nginx кэширует ответы, используя значение TTL из ответа.
215 Необязательный параметр <literal>valid</literal> позволяет это
216 переопределить:
217 <example>
218 resolver 127.0.0.1 [::1]:5353 valid=30s;
219 </example>
220 <note>
221 До версии 1.1.9 настройка времени кэширования была невозможна
222 и nginx всегда кэшировал ответы на срок в 5 минут.
223 </note>
224 </para>
225
226 <para>
227 Специальное значение <literal>off</literal> запрещает использование DNS.
228 </para>
229
230 </directive>
231
232
233 <directive name="resolver_timeout">
234 <syntax><value>время</value></syntax>
235 <default>30s</default>
236 <context>mail</context>
237 <context>server</context>
238
239 <para>
240 Задаёт таймаут для операций DNS, например:
241 <example>
242 resolver_timeout 5s;
243 </example>
244 </para>
245
246 </directive>
247
248
185 <directive name="server"> 249 <directive name="server">
186 <syntax block="yes"/> 250 <syntax block="yes"/>
187 <default/> 251 <default/>
188 <context>mail</context> 252 <context>mail</context>
189 253