Mercurial > hg > nginx-site
diff xml/ru/docs/http/ngx_http_proxy_module.xml @ 405:781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
proxy_max_temp_file_size, and proxy_temp_file_write_size.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Fri, 10 Feb 2012 13:27:50 +0000 |
parents | bb51d3e17dd0 |
children | cbc2d1b51cb6 |
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 @@ -59,14 +59,18 @@ location / { <context>location</context> <para> -Разрешает или запрещает использовать буферизацию ответа проксируемого сервера. +Разрешает или запрещает использовать буферизацию ответов проксируемого сервера. </para> <para> Если буферизация включена, то nginx принимает ответ проксируемого сервера как можно быстрее, сохраняя его в буферы, заданные директивами <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>. -Если ответ не вмещается целиком в память, то его часть записывается на диск. +Если ответ не вмещается целиком в память, то его часть может быть записана +на диск во <link id="proxy_temp_path">временный файл</link>. +Запись во временные файлы контролируется директивами +<link id="proxy_max_temp_file_size"/> и +<link id="proxy_temp_file_write_size"/>. </para> <para> @@ -98,6 +102,27 @@ nginx не пытается считать весь ответ проксируемого сервера. </directive> +<directive name="proxy_busy_buffers_size"> +<syntax><value>размер</value></syntax> +<default>8k|16k</default> +<context>http</context> +<context>server</context> +<context>location</context> + +<para> +При включённой <link id="proxy_buffering">буферизации</link> ответов +проксируемого сервера, ограничивает суммарный <value>размер</value> +буферов, которые могут быть заняты для отправки ответа клиенту, пока +ответ ещё не прочитан целиком. +Оставшиеся буферы тем временем могут использоваться для чтения ответа +и, при необходимости, буферизации части ответа во временный файл. +По умолчанию <value>размер</value> ограничен двумя буферами, заданными +директивами <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>. +</para> + +</directive> + + <directive name="proxy_cache"> <syntax><value>зона</value> | <literal>off</literal></syntax> <default>off</default> @@ -439,6 +464,30 @@ nginx не передаёт клиенту поля заголовка <header>Date</header>, </directive> +<directive name="proxy_max_temp_file_size"> +<syntax><value>размер</value></syntax> +<default>1024m</default> +<context>http</context> +<context>server</context> +<context>location</context> + +<para> +Если включена <link id="proxy_buffering">буферизация</link> ответов +проксируемого сервера, и ответ не вмещается целиком в буферы памяти, +заданные директивами <link id="proxy_buffer_size"/> и +<link id="proxy_buffers"/>, часть ответа может быть записана во временный файл. +Эта директива задаёт максимальный <value>размер</value> временного файла. +Размер данных, сбрасываемых во временный файл за один раз, задаётся +директивой <link id="proxy_temp_file_write_size"/>. +</para> + +<para> +Значение 0 отключает возможность буферизации ответов во временные файлы. +</para> + +</directive> + + <directive name="proxy_next_upstream"> <syntax> <literal>error</literal> | @@ -983,6 +1032,26 @@ proxy_store_access group:rw all:r; </directive> +<directive name="proxy_temp_file_write_size"> +<syntax><value>размер</value></syntax> +<default>8k|16k</default> +<context>http</context> +<context>server</context> +<context>location</context> + +<para> +Ограничивает <value>размер</value> данных, сбрасываемых во временный файл +за один раз, при включённой буферизации ответов проксируемого сервера +во временные файлы. +По умолчанию <value>размер</value> ограничен двумя буферами, заданными +директивами <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>. +Максимальный размер временного файла задаётся директивой +<link id="proxy_max_temp_file_size"/>. +</para> + +</directive> + + <directive name="proxy_temp_path"> <syntax> <value>путь</value> @@ -995,8 +1064,8 @@ proxy_store_access group:rw all:r; <context>location</context> <para> -Задаёт имя каталога для хранения временных файлов, -полученных от другого сервера. +Задаёт имя каталога для хранения временных файлов с данными, +полученными от проксируемых серверов. В каталоге может использоваться иерархия подкаталогов до трёх уровней. Например, при такой конфигурации <example>