nginx-site: xml/ru/docs/http/ngx_http_proxy

comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 279:fa1213cffc34

Revision.

author	Ruslan Ermilov <ru@nginx.com>
date	Tue, 27 Dec 2011 09:55:41 +0000
parents	44ab4026d9f5
children	fd85955f31aa

comparison

equal deleted inserted replaced

-:ee8368ab093b
+:fa1213cffc34
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <para>
-Задаёт размер буфера, в который будет читаться
+Задаёт <value>размер</value> буфера, в который будет читаться
 первая часть ответа, получаемого от проксируемого сервера.
 В этой части ответа находится, как правило, небольшой заголовок ответа.
 По умолчанию размер буфера равен размеру одного буфера в директиве
 <link id="proxy_buffers"/>, однако его можно сделать меньше.
 </para>
 <para>
 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же
 по мере его поступления.
 nginx не пытается считать весь ответ проксируемого сервера.
-Максимальный размер данных, который nginx может принять от сервера,
+Максимальный размер данных, который nginx может принять от сервера
-задаётся директивой <link id="proxy_buffer_size"/>.
+за один раз, задаётся директивой <link id="proxy_buffer_size"/>.
 </para>
 </directive>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <para>
-Задаёт число и размер буферов для одного соединения,
+Задаёт <value>число</value> и <value>размер</value> буферов
+для одного соединения,
 в которые будет читаться ответ, получаемый от проксируемого сервера.
 По умолчанию размер одного буфера равен размеру страницы.
 В зависимости от платформы это или 4K, или 8K.
 </para>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <para>
-Задаёт число запросов, после которого ответ будет закэширован.
+Задаёт <value>число</value> запросов, после которого ответ будет закэширован.
 </para>
 </directive>
 <directive name="proxy_cache_path">
 <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/>
 <context>http</context>
 <example>
 proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=one:10m;
 </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, временные файлы и кэш
 могут располагаться на разных файловых системах, но нужно учитывать,
 что в этом случае вместо дешёвой операции переименовывания в пределах
 одной файловой системы файл копируется с одной файловой системы на другую.
 Поэтому лучше, если кэш будет находиться на той же файловой
 <link id="proxy_temp_path"/> для данного location.
 </para>
 <para>
 Кроме того, все активные ключи и информация о данных хранятся в разделяемой
-памяти — зоне, имя и размер которой задаётся параметром
+памяти — зоне, <value>имя</value> и <value>размер</value> которой
-<literal>keys_zone</literal>.
+задаются параметром <literal>keys_zone</literal>.
 Если к данным кэша не обращаются в течение времени, заданного параметром
 <literal>inactive</literal>, то данные удаляются, независимо от их свежести.
 По умолчанию <literal>inactive</literal> равен 10 минутам.
 </para>
 <context>http</context>
 <context>server</context>
 <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>
 </directive>
 <para>
 Задаёт таймаут при чтении ответа проксированного сервера.
 Таймаут устанавливается не на всю передачу ответа,
 а только между двумя операциями чтения.
 Если по истечении этого времени проксируемый сервер ничего не передаст,
-то nginx закрывает соединение.
+соединение закрывается.
 </para>
 </directive>
 </example>
 тогда будет подставлено основное имя сервера и порт, если он отличен от 80.
 </para>
 <para>
-Изменение по умолчанию, задаваемое значением <literal>default</literal>,
+Стандартная замена, задаваемая параметром <literal>default</literal>,
 использует параметры директив
 <link doc="ngx_http_core_module.xml" id="location"/> и
 <link id="proxy_pass"/>.
 Поэтому две нижеприведённые конфигурации одинаковы:
 <example>
 <example>
 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>
 </para>
 proxy_redirect ~*/user/([^/]+)/(.+)$      http://$1.example.com/$2;
 </example>
 </para>
 <para>
-Директив может быть несколько:
+Директив <literal>proxy_redirect</literal> может быть несколько:
 <example>
 proxy_redirect default;
 proxy_redirect http://localhost:8000/  /;
 proxy_redirect http://www.example.com/ /;
 </example>
 </para>
 <para>
-Значение <literal>off</literal> запрещает все директивы
+Параметр <literal>off</literal> запрещает все директивы
 <literal>proxy_redirect</literal>
 на данном уровне:
 <example>
 proxy_redirect off;
 proxy_redirect default;
 </directive>
 <directive name="proxy_send_timeout">
 <syntax><value>время</value></syntax>
-<default>60</default>
+<default>60s</default>
 <context>http</context>
 <context>server</context>
 <context>location</context>
 <para>
 Задаёт таймаут при передаче запроса проксированному серверу.
 Таймаут устанавливается не на всю передачу запроса,
 а только между двумя операциями записи.
 Если по истечении этого времени проксируемый сервер не примет новых данных,
-то nginx закрывает соединение.
+соединение закрывается.
 </para>
 </directive>
 </para>
 <para>
 Однако, если это поле отсутствует в заголовке запроса клиента, то ничего
 передаваться не будет. В этом случае лучше воспользоваться переменной
-<var>$host</var> - её значение равно имени сервера в поле <header>Host</header>
+<var>$host</var>&mdash;её значение равно имени сервера в поле <header>Host</header>
 заголовка запроса, или же основному имени сервера, если поля нет:
 <example>
 proxy_set_header Host       $host;
 </example>
 </para>
 </para>
 <para>
 Время изменения файлов выставляется согласно полученному полю
 <header>Last-Modified</header> в заголовке ответа.
-Ответ записывается во временный файл, а потом этот файл переименовывается.
+Ответ сначала записывается во временный файл, а потом этот файл
+переименовывается.
 Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа
 могут располагаться на разных файловых системах, но нужно учитывать,
 что в этом случае вместо дешёвой операции переименовывания в пределах
 одной файловой системы файл копируется с одной файловой системы на другую.
 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой
 <example>
 proxy_temp_path /spool/nginx/proxy_temp 1 2;
 </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>
 </directive>

Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 279:fa1213cffc34