Mercurial > hg > nginx-site
changeset 279:fa1213cffc34
Revision.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Tue, 27 Dec 2011 09:55:41 +0000 |
parents | ee8368ab093b |
children | cbb789d3ce5e |
files | xml/ru/docs/http/ngx_http_proxy_module.xml |
diffstat | 1 files changed, 32 insertions(+), 27 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml Tue Dec 27 03:53:41 2011 +0000 +++ b/xml/ru/docs/http/ngx_http_proxy_module.xml Tue Dec 27 09:55:41 2011 +0000 @@ -41,7 +41,7 @@ <context>location</context> <para> -Задаёт размер буфера, в который будет читаться +Задаёт <value>размер</value> буфера, в который будет читаться первая часть ответа, получаемого от проксируемого сервера. В этой части ответа находится, как правило, небольшой заголовок ответа. По умолчанию размер буфера равен размеру одного буфера в директиве @@ -73,8 +73,8 @@ Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же по мере его поступления. nginx не пытается считать весь ответ проксируемого сервера. -Максимальный размер данных, который nginx может принять от сервера, -задаётся директивой <link id="proxy_buffer_size"/>. +Максимальный размер данных, который nginx может принять от сервера +за один раз, задаётся директивой <link id="proxy_buffer_size"/>. </para> </directive> @@ -88,7 +88,8 @@ <context>location</context> <para> -Задаёт число и размер буферов для одного соединения, +Задаёт <value>число</value> и <value>размер</value> буферов +для одного соединения, в которые будет читаться ответ, получаемый от проксируемого сервера. По умолчанию размер одного буфера равен размеру страницы. В зависимости от платформы это или 4K, или 8K. @@ -164,7 +165,7 @@ <context>location</context> <para> -Задаёт число запросов, после которого ответ будет закэширован. +Задаёт <value>число</value> запросов, после которого ответ будет закэширован. </para> </directive> @@ -174,7 +175,7 @@ <syntax> <value>путь</value> [<literal>levels</literal>=<value>уровни</value>] - <literal>keys_zone</literal>=<value>название</value>:<value>размер</value> + <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value> [<literal>inactive</literal>=<value>время</value>] [<literal>max_size</literal>=<value>размер</value>]</syntax> <default/> @@ -192,12 +193,12 @@ </example> имена файлов в кэше будут такого вида: <example> -/data/nginx/cache/<emphasis>c/29</emphasis>/b7f54b2df7773722d382f4809d650<emphasis>29c</emphasis> +/data/nginx/cache/<emphasis>c</emphasis>/<emphasis>29</emphasis>/b7f54b2df7773722d382f4809d650<emphasis>29c</emphasis> </example> </para> <para> -Кэшируемый ответ записывается во временный файл, а потом этот файл +Кэшируемый ответ сначала записывается во временный файл, а потом этот файл переименовывается. Начиная с версии 0.8.9, временные файлы и кэш могут располагаться на разных файловых системах, но нужно учитывать, что в этом случае вместо дешёвой операции переименовывания в пределах @@ -209,8 +210,8 @@ <para> Кроме того, все активные ключи и информация о данных хранятся в разделяемой -памяти — зоне, имя и размер которой задаётся параметром -<literal>keys_zone</literal>. +памяти — зоне, <value>имя</value> и <value>размер</value> которой +задаются параметром <literal>keys_zone</literal>. Если к данным кэша не обращаются в течение времени, заданного параметром <literal>inactive</literal>, то данные удаляются, независимо от их свежести. По умолчанию <literal>inactive</literal> равен 10 минутам. @@ -303,26 +304,28 @@ <context>location</context> <para> -Задаёт таймаут для соединения с проксированным сервером. -Необходимо иметь в виду, что этот таймаут не может быть больше 75 секунд. +Задаёт таймаут для установления соединения с проксированным сервером. +Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд. </para> </directive> <directive name="proxy_hide_header"> -<syntax><value>имя</value></syntax> +<syntax><value>поле</value></syntax> <default/> <context>http</context> <context>server</context> <context>location</context> <para> +По умолчанию nginx не передаёт клиенту поля заголовка <header>Date</header>, <header>Server</header>, <header>X-Pad</header> и <header>X-Accel-...</header> из ответа проксированного сервера. -Директива <literal>proxy_hide_header</literal> задаёт дополнительные поля. -Если же поля нужно напротив разрешить, следует воспользоваться +Директива <literal>proxy_hide_header</literal> задаёт дополнительные поля, +которые не будут передаваться. +Если же передачу полей нужно напротив разрешить, можно воспользоваться директивой <link id="proxy_pass_header"/>. </para> @@ -600,7 +603,7 @@ Таймаут устанавливается не на всю передачу ответа, а только между двумя операциями чтения. Если по истечении этого времени проксируемый сервер ничего не передаст, -то nginx закрывает соединение. +соединение закрывается. </para> </directive> @@ -638,7 +641,7 @@ </para> <para> -Изменение по умолчанию, задаваемое значением <literal>default</literal>, +Стандартная замена, задаваемая параметром <literal>default</literal>, использует параметры директив <link doc="ngx_http_core_module.xml" id="location"/> и <link id="proxy_pass"/>. @@ -654,19 +657,20 @@ proxy_pass http://upstream:port/two/; proxy_redirect http://upstream:port/two/ /one/; </example> -Значение <literal>default</literal> недопустимо, если в <link id="proxy_pass"/> +Параметр <literal>default</literal> недопустим, если в <link id="proxy_pass"/> используются переменные. </para> <para> -В заменяемой строке можно использовать переменные: +В строке <value>замена</value> можно использовать переменные: <example> proxy_redirect http://localhost:8000/ http://$host:$server_port/; </example> </para> <para> -В перенаправлении тоже можно использовать (1.1.11) переменные: +В строке <value>перенаправление</value> тоже можно использовать (1.1.11) +переменные: <example> proxy_redirect http://$proxy_host:8000/ /; </example> @@ -687,7 +691,7 @@ </para> <para> -Директив может быть несколько: +Директив <literal>proxy_redirect</literal> может быть несколько: <example> proxy_redirect default; proxy_redirect http://localhost:8000/ /; @@ -696,7 +700,7 @@ </para> <para> -Значение <literal>off</literal> запрещает все директивы +Параметр <literal>off</literal> запрещает все директивы <literal>proxy_redirect</literal> на данном уровне: <example> @@ -720,7 +724,7 @@ <directive name="proxy_send_timeout"> <syntax><value>время</value></syntax> -<default>60</default> +<default>60s</default> <context>http</context> <context>server</context> <context>location</context> @@ -730,7 +734,7 @@ Таймаут устанавливается не на всю передачу запроса, а только между двумя операциями записи. Если по истечении этого времени проксируемый сервер не примет новых данных, -то nginx закрывает соединение. +соединение закрывается. </para> </directive> @@ -767,7 +771,7 @@ <para> Однако, если это поле отсутствует в заголовке запроса клиента, то ничего передаваться не будет. В этом случае лучше воспользоваться переменной -<var>$host</var> - её значение равно имени сервера в поле <header>Host</header> +<var>$host</var>—её значение равно имени сервера в поле <header>Host</header> заголовка запроса, или же основному имени сервера, если поля нет: <example> proxy_set_header Host $host; @@ -836,7 +840,8 @@ <para> Время изменения файлов выставляется согласно полученному полю <header>Last-Modified</header> в заголовке ответа. -Ответ записывается во временный файл, а потом этот файл переименовывается. +Ответ сначала записывается во временный файл, а потом этот файл +переименовывается. Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа могут располагаться на разных файловых системах, но нужно учитывать, что в этом случае вместо дешёвой операции переименовывания в пределах @@ -940,7 +945,7 @@ </example> временный файл будет следующего вида: <example> -/spool/nginx/proxy_temp/7/45/00000123457 +/spool/nginx/proxy_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis> </example> </para>