Mercurial > hg > nginx-site
changeset 527:58d79f8c412d
Documented 1.3.1 changes in "resolver".
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Tue, 05 Jun 2012 22:11:50 +0000 |
parents | 4f907cde0382 |
children | 85bbe7a5f393 |
files | xml/en/docs/http/ngx_http_core_module.xml xml/ru/docs/http/ngx_http_core_module.xml |
diffstat | 2 files changed, 24 insertions(+), 12 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_core_module.xml Tue Jun 05 21:42:57 2012 +0000 +++ b/xml/en/docs/http/ngx_http_core_module.xml Tue Jun 05 22:11:50 2012 +0000 @@ -1845,22 +1845,28 @@ <context>location</context> <para> -Configures name servers used to resolve names of upstream servers, -for example: +Configures name servers used to resolve names of upstream servers +into addresses, for example: <example> -resolver 127.0.0.1 192.0.2.1; +resolver 127.0.0.1 [::1]:5353; </example> -An <value>address</value> parameter may be specified as -either an IPv4 address or a hostname; -in the latter case, the first resolved IPv4 address is used. +An address can be specified as a domain name or IP address, +and an optional port (1.3.1). +<!-- +If address is specified using a domain name, only the first +resolved IPv4 address is used. +--> +If port is not specified, the port 53 is used. Name servers are queried in a round-robin fashion. <note> Before version 1.1.7, only a single name server could be configured. +Specifying name servers using IPv6 addresses is supported +starting from version 1.3.1. </note> By default, nginx caches answers using the TTL value of a response. An optional <literal>valid</literal> parameter allows to override it: <example> -resolver 127.0.0.1 192.0.2.1 valid=30s; +resolver 127.0.0.1 [::1]:5353 valid=30s; </example> <note> Before version 1.1.9, tuning of caching time was not possible,
--- a/xml/ru/docs/http/ngx_http_core_module.xml Tue Jun 05 21:42:57 2012 +0000 +++ b/xml/ru/docs/http/ngx_http_core_module.xml Tue Jun 05 22:11:50 2012 +0000 @@ -1832,20 +1832,26 @@ Задаёт серверы DNS, используемые для преобразования имён вышестоящих серверов в адреса, например: <example> -resolver 127.0.0.1 192.0.2.1; +resolver 127.0.0.1 [::1]:5353; </example> -Параметр <value>адрес</value> может быть задан либо -IPv4-адресом, либо именем хоста; -во втором случае используется первый полученный IPv4-адрес. +Адрес может быть указан в виде доменного имени или IP-адреса, +и необязательного порта (1.3.1). +<!-- +Если адрес указан в виде доменного имени, используется только первый +IPv4-адрес, соответствующий имени. +--> +Если порт не указан, используется порт 53. Серверы DNS опрашиваются циклически. <note> До версии 1.1.7 можно было задать лишь один DNS-сервер. +Задание DNS-серверов с помощью IPv6-адресов поддерживается +начиная с версии 1.3.1. </note> По умолчанию nginx кэширует ответы, используя значение TTL из ответа. Необязательный параметр <literal>valid</literal> позволяет это переопределить: <example> -resolver 127.0.0.1 192.0.2.1 valid=30s; +resolver 127.0.0.1 [::1]:5353 valid=30s; </example> <note> До версии 1.1.9 настройка времени кэширования была невозможна