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
+++ b/xml/ru/docs/http/ngx_http_proxy_module.xml
@@ -41,7 +41,7 @@ location / {
 <context>location</context>
 
 <para>
-Задаёт размер буфера, в который будет читаться
+Задаёт <value>размер</value> буфера, в который будет читаться
 первая часть ответа, получаемого от проксируемого сервера.
 В этой части ответа находится, как правило, небольшой заголовок ответа.
 По умолчанию размер буфера равен размеру одного буфера в директиве
@@ -73,8 +73,8 @@ location / {
 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же
 по мере его поступления.
 nginx не пытается считать весь ответ проксируемого сервера.
-Максимальный размер данных, который nginx может принять от сервера,
-задаётся директивой <link id="proxy_buffer_size"/>.
+Максимальный размер данных, который nginx может принять от сервера
+за один раз, задаётся директивой <link id="proxy_buffer_size"/>.
 </para>
 
 </directive>
@@ -88,7 +88,8 @@ nginx не пытается считать весь ответ проксируемого сервера.
 <context>location</context>
 
 <para>
-Задаёт число и размер буферов для одного соединения,
+Задаёт <value>число</value> и <value>размер</value> буферов
+для одного соединения,
 в которые будет читаться ответ, получаемый от проксируемого сервера.
 По умолчанию размер одного буфера равен размеру страницы.
 В зависимости от платформы это или 4K, или 8K.
@@ -164,7 +165,7 @@ proxy_cache_key $scheme$proxy_host$uri$i
 <context>location</context>
 
 <para>
-Задаёт число запросов, после которого ответ будет закэширован.
+Задаёт <value>число</value> запросов, после которого ответ будет закэширован.
 </para>
 
 </directive>
@@ -174,7 +175,7 @@ proxy_cache_key $scheme$proxy_host$uri$i
 <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 @@ proxy_cache_path /data/nginx/cache level
 </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 @@ proxy_cache_path /data/nginx/cache level
 
 <para>
 Кроме того, все активные ключи и информация о данных хранятся в разделяемой
-памяти — зоне, имя и размер которой задаётся параметром
-<literal>keys_zone</literal>.
+памяти — зоне, <value>имя</value> и <value>размер</value> которой
+задаются параметром <literal>keys_zone</literal>.
 Если к данным кэша не обращаются в течение времени, заданного параметром
 <literal>inactive</literal>, то данные удаляются, независимо от их свежести.
 По умолчанию <literal>inactive</literal> равен 10 минутам.
@@ -303,26 +304,28 @@ proxy_cache_valid any      1m;
 <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 @@ location /some/path/ {
 Таймаут устанавливается не на всю передачу ответа,
 а только между двумя операциями чтения.
 Если по истечении этого времени проксируемый сервер ничего не передаст,
-то nginx закрывает соединение.
+соединение закрывается.
 </para>
 
 </directive>
@@ -638,7 +641,7 @@ location /some/path/ {
 </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 @@ location /one/ {
     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 @@ location /one/ {
 </para>
 
 <para>
-Директив может быть несколько:
+Директив <literal>proxy_redirect</literal> может быть несколько:
 <example>
     proxy_redirect default;
     proxy_redirect http://localhost:8000/  /;
@@ -696,7 +700,7 @@ location /one/ {
 </para>
 
 <para>
-Значение <literal>off</literal> запрещает все директивы
+Параметр <literal>off</literal> запрещает все директивы
 <literal>proxy_redirect</literal>
 на данном уровне:
 <example>
@@ -720,7 +724,7 @@ location /one/ {
 
 <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 @@ location /one/ {
 Таймаут устанавливается не на всю передачу запроса,
 а только между двумя операциями записи.
 Если по истечении этого времени проксируемый сервер не примет новых данных,
-то nginx закрывает соединение.
+соединение закрывается.
 </para>
 
 </directive>
@@ -767,7 +771,7 @@ proxy_set_header Host       $http_host;
 <para>
 Однако, если это поле отсутствует в заголовке запроса клиента, то ничего
 передаваться не будет. В этом случае лучше воспользоваться переменной
-<var>$host</var> - её значение равно имени сервера в поле <header>Host</header>
+<var>$host</var>&mdash;её значение равно имени сервера в поле <header>Host</header>
 заголовка запроса, или же основному имени сервера, если поля нет:
 <example>
 proxy_set_header Host       $host;
@@ -836,7 +840,8 @@ proxy_store /data/www$original_uri;
 <para>
 Время изменения файлов выставляется согласно полученному полю
 <header>Last-Modified</header> в заголовке ответа.
-Ответ записывается во временный файл, а потом этот файл переименовывается.
+Ответ сначала записывается во временный файл, а потом этот файл
+переименовывается.
 Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа
 могут располагаться на разных файловых системах, но нужно учитывать,
 что в этом случае вместо дешёвой операции переименовывания в пределах
@@ -940,7 +945,7 @@ proxy_temp_path /spool/nginx/proxy_temp 
 </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>