Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 405:781b23ba3b0a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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
comparison
equal deleted inserted replaced
404:1bd794e9cea4 405:781b23ba3b0a
57 <context>http</context> 57 <context>http</context>
58 <context>server</context> 58 <context>server</context>
59 <context>location</context> 59 <context>location</context>
60 60
61 <para> 61 <para>
62 Разрешает или запрещает использовать буферизацию ответа проксируемого сервера. 62 Разрешает или запрещает использовать буферизацию ответов проксируемого сервера.
63 </para> 63 </para>
64 64
65 <para> 65 <para>
66 Если буферизация включена, то nginx принимает ответ проксируемого сервера 66 Если буферизация включена, то nginx принимает ответ проксируемого сервера
67 как можно быстрее, сохраняя его в буферы, заданные директивами 67 как можно быстрее, сохраняя его в буферы, заданные директивами
68 <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>. 68 <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>.
69 Если ответ не вмещается целиком в память, то его часть записывается на диск. 69 Если ответ не вмещается целиком в память, то его часть может быть записана
70 на диск во <link id="proxy_temp_path">временный файл</link>.
71 Запись во временные файлы контролируется директивами
72 <link id="proxy_max_temp_file_size"/> и
73 <link id="proxy_temp_file_write_size"/>.
70 </para> 74 </para>
71 75
72 <para> 76 <para>
73 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же 77 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же
74 по мере его поступления. 78 по мере его поступления.
91 Задаёт <value>число</value> и <value>размер</value> буферов 95 Задаёт <value>число</value> и <value>размер</value> буферов
92 для одного соединения, 96 для одного соединения,
93 в которые будет читаться ответ, получаемый от проксируемого сервера. 97 в которые будет читаться ответ, получаемый от проксируемого сервера.
94 По умолчанию размер одного буфера равен размеру страницы. 98 По умолчанию размер одного буфера равен размеру страницы.
95 В зависимости от платформы это или 4K, или 8K. 99 В зависимости от платформы это или 4K, или 8K.
100 </para>
101
102 </directive>
103
104
105 <directive name="proxy_busy_buffers_size">
106 <syntax><value>размер</value></syntax>
107 <default>8k|16k</default>
108 <context>http</context>
109 <context>server</context>
110 <context>location</context>
111
112 <para>
113 При включённой <link id="proxy_buffering">буферизации</link> ответов
114 проксируемого сервера, ограничивает суммарный <value>размер</value>
115 буферов, которые могут быть заняты для отправки ответа клиенту, пока
116 ответ ещё не прочитан целиком.
117 Оставшиеся буферы тем временем могут использоваться для чтения ответа
118 и, при необходимости, буферизации части ответа во временный файл.
119 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
120 директивами <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>.
96 </para> 121 </para>
97 122
98 </directive> 123 </directive>
99 124
100 125
437 </para> 462 </para>
438 463
439 </directive> 464 </directive>
440 465
441 466
467 <directive name="proxy_max_temp_file_size">
468 <syntax><value>размер</value></syntax>
469 <default>1024m</default>
470 <context>http</context>
471 <context>server</context>
472 <context>location</context>
473
474 <para>
475 Если включена <link id="proxy_buffering">буферизация</link> ответов
476 проксируемого сервера, и ответ не вмещается целиком в буферы памяти,
477 заданные директивами <link id="proxy_buffer_size"/> и
478 <link id="proxy_buffers"/>, часть ответа может быть записана во временный файл.
479 Эта директива задаёт максимальный <value>размер</value> временного файла.
480 Размер данных, сбрасываемых во временный файл за один раз, задаётся
481 директивой <link id="proxy_temp_file_write_size"/>.
482 </para>
483
484 <para>
485 Значение 0 отключает возможность буферизации ответов во временные файлы.
486 </para>
487
488 </directive>
489
490
442 <directive name="proxy_next_upstream"> 491 <directive name="proxy_next_upstream">
443 <syntax> 492 <syntax>
444 <literal>error</literal> | 493 <literal>error</literal> |
445 <literal>timeout</literal> | 494 <literal>timeout</literal> |
446 <literal>invalid_header</literal> | 495 <literal>invalid_header</literal> |
981 </para> 1030 </para>
982 1031
983 </directive> 1032 </directive>
984 1033
985 1034
1035 <directive name="proxy_temp_file_write_size">
1036 <syntax><value>размер</value></syntax>
1037 <default>8k|16k</default>
1038 <context>http</context>
1039 <context>server</context>
1040 <context>location</context>
1041
1042 <para>
1043 Ограничивает <value>размер</value> данных, сбрасываемых во временный файл
1044 за один раз, при включённой буферизации ответов проксируемого сервера
1045 во временные файлы.
1046 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
1047 директивами <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>.
1048 Максимальный размер временного файла задаётся директивой
1049 <link id="proxy_max_temp_file_size"/>.
1050 </para>
1051
1052 </directive>
1053
1054
986 <directive name="proxy_temp_path"> 1055 <directive name="proxy_temp_path">
987 <syntax> 1056 <syntax>
988 <value>путь</value> 1057 <value>путь</value>
989 [<value>уровень1</value> 1058 [<value>уровень1</value>
990 [<value>уровень2</value> 1059 [<value>уровень2</value>
993 <context>http</context> 1062 <context>http</context>
994 <context>server</context> 1063 <context>server</context>
995 <context>location</context> 1064 <context>location</context>
996 1065
997 <para> 1066 <para>
998 Задаёт имя каталога для хранения временных файлов, 1067 Задаёт имя каталога для хранения временных файлов с данными,
999 полученных от другого сервера. 1068 полученными от проксируемых серверов.
1000 В каталоге может использоваться иерархия подкаталогов до трёх уровней. 1069 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
1001 Например, при такой конфигурации 1070 Например, при такой конфигурации
1002 <example> 1071 <example>
1003 proxy_temp_path /spool/nginx/proxy_temp 1 2; 1072 proxy_temp_path /spool/nginx/proxy_temp 1 2;
1004 </example> 1073 </example>