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

annotate xml/ru/docs/http/ngx_http_proxy_module.xml @ 364:bb51d3e17dd0

Style fixed.

author	Ruslan Ermilov <ru@nginx.com>
date	Fri, 27 Jan 2012 10:39:12 +0000
parents	a4fa80755eab
children	781b23ba3b0a

rev	line source
222 bfe3eff81d04 Removed redundant encoding specification. Ruslan Ermilov <ru@nginx.com> parents: 135 diff changeset	1 <?xml version="1.0"?>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	2
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	3 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	4
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	5 <module name="Модуль ngx_http_proxy_module"
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	6 link="/ru/docs/http/ngx_http_proxy_module.html"
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	7 lang="ru">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	8
110 40eec261c2a6 Added proper support for anonymous sections, notably for the summary. Ruslan Ermilov <ru@nginx.com> parents: 106 diff changeset	9 <section id="summary">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	10
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	11 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	12 Модуль <literal>ngx_http_proxy_module</literal> позволяет передавать
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	13 запросы другому серверу.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	14 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	15
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	16 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	17
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	18
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	19 <section id="example" name="Пример конфигурации">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	20
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	21 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	22 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	23 location / {
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	24 proxy_pass http://localhost:8000;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	25 proxy_set_header Host $host;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	26 proxy_set_header X-Real-IP $remote_addr;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	27 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	28 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	29 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	30
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	31 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	32
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	33
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	34 <section id="directives" name="Директивы">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	35
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	36 <directive name="proxy_buffer_size">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	37 <syntax><value>размер</value></syntax>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	38 <default>4k\|8k</default>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	39 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	40 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	41 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	42
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	43 <para>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	44 Задаёт <value>размер</value> буфера, в который будет читаться
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	45 первая часть ответа, получаемого от проксируемого сервера.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	46 В этой части ответа находится, как правило, небольшой заголовок ответа.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	47 По умолчанию размер буфера равен размеру одного буфера в директиве
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	48 <link id="proxy_buffers"/>, однако его можно сделать меньше.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	49 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	50
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	51 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	52
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	53
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	54 <directive name="proxy_buffering">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	55 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	56 <default>on</default>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	57 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	58 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	59 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	60
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	61 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	62 Разрешает или запрещает использовать буферизацию ответа проксируемого сервера.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	63 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	64
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	65 <para>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	66 Если буферизация включена, то nginx принимает ответ проксируемого сервера
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	67 как можно быстрее, сохраняя его в буферы, заданные директивами
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	68 <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>.
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	69 Если ответ не вмещается целиком в память, то его часть записывается на диск.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	70 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	71
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	72 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	73 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	74 по мере его поступления.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	75 nginx не пытается считать весь ответ проксируемого сервера.
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	76 Максимальный размер данных, который nginx может принять от сервера
fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	77 за один раз, задаётся директивой <link id="proxy_buffer_size"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	78 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	79
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	80 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	81
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	82
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	83 <directive name="proxy_buffers">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	84 <syntax><value>число</value> <value>размер</value></syntax>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	85 <default>8 4k\|8k</default>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	86 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	87 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	88 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	89
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	90 <para>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	91 Задаёт <value>число</value> и <value>размер</value> буферов
fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	92 для одного соединения,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	93 в которые будет читаться ответ, получаемый от проксируемого сервера.
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	94 По умолчанию размер одного буфера равен размеру страницы.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	95 В зависимости от платформы это или 4K, или 8K.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	96 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	97
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	98 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	99
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	100
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	101 <directive name="proxy_cache">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	102 <syntax><value>зона</value> \| <literal>off</literal></syntax>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	103 <default>off</default>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	104 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	105 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	106 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	107
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	108 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	109 Задаёт зону для кэширования.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	110 Одна и та же зона может использоваться в нескольких местах.
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	111 Параметр <literal>off</literal> запрещает кэширование, унаследованное
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	112 с предыдущего уровня конфигурации.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	113 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	114
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	115 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	116
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	117
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	118 <directive name="proxy_cache_bypass">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	119 <syntax><value>строка</value> ...</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	120 <default/>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	121 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	122 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	123 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	124
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	125 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	126 Задаёт условия, при которых ответ не будет браться из кэша.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	127 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	128 то ответ не берётся из кэша:
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	129 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	130 proxy_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	131 proxy_cache_bypass $http_pragma $http_authorization;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	132 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	133 Можно использовать совместно с директивой <link id="proxy_no_cache"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	134 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	135
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	136 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	137
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	138
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	139 <directive name="proxy_cache_key">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	140 <syntax><value>строка</value></syntax>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	141 <default>$scheme$proxy_host$request_uri</default>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	142 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	143 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	144 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	145
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	146 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	147 Задаёт ключ для кэширования, например,
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	148 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	149 proxy_cache_key "$host$request_uri $cookie_user";
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	150 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	151 По умолчанию значение директивы близко к строке
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	152 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	153 proxy_cache_key $scheme$proxy_host$uri$is_args$args;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	154 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	155 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	156
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	157 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	158
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	159
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	160 <directive name="proxy_cache_lock">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	161 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	162 <default>off</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	163 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	164 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	165 <context>location</context>
310 86732337c730 Added a historical information for proxy_cache_lock, proxy_cache_lock_timeout, Ruslan Ermilov <ru@nginx.com> parents: 302 diff changeset	166 <appeared-in>1.1.12</appeared-in>
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	167
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	168 <para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	169 Если включено, одновременно только одному запросу будет позволено
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	170 заполнить новый элемент кэша, идентифицируемый согласно директиве
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	171 <link id="proxy_cache_key"/>, передав запрос на проксируемый сервер.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	172 Остальные запросы этого же элемента будут либо ожидать
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	173 появления ответа в кэше, либо освобождения блокировки
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	174 этого элемента, в течение времени, заданного директивой
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	175 <link id="proxy_cache_lock_timeout"/>.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	176 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	177
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	178 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	179
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	180
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	181 <directive name="proxy_cache_lock_timeout">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	182 <syntax><value>время</value></syntax>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	183 <default>5s</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	184 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	185 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	186 <context>location</context>
310 86732337c730 Added a historical information for proxy_cache_lock, proxy_cache_lock_timeout, Ruslan Ermilov <ru@nginx.com> parents: 302 diff changeset	187 <appeared-in>1.1.12</appeared-in>
302 df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	188
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	189 <para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	190 Задаёт таймаут для <link id="proxy_cache_lock"/>.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	191 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	192
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	193 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	194
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout", Ruslan Ermilov <ru@nginx.com> parents: 296 diff changeset	195
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	196 <directive name="proxy_cache_min_uses">
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	197 <syntax><value>число</value></syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	198 <default>1</default>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	199 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	200 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	201 <context>location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	202
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	203 <para>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	204 Задаёт <value>число</value> запросов, после которого ответ будет закэширован.
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	205 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	206
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	207 </directive>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	208
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	209
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	210 <directive name="proxy_cache_path">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	211 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	212 <value>путь</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	213 [<literal>levels</literal>=<value>уровни</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	214 <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	215 [<literal>inactive</literal>=<value>время</value>]
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	216 [<literal>max_size</literal>=<value>размер</value>]</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	217 <default/>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	218 <context>http</context>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	219
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	220 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	221 Задаёт путь и другие параметры кэша.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	222 Данные кэша хранятся в файлах.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	223 Ключом и именем файла в кэше является результат функции MD5
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	224 от проксированного URL.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	225 Параметр <literal>levels</literal> задаёт уровни иерархии кэша,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	226 например, при использовании
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	227 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	228 proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=one:10m;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	229 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	230 имена файлов в кэше будут такого вида:
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	231 <example>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	232 /data/nginx/cache/<emphasis>c</emphasis>/<emphasis>29</emphasis>/b7f54b2df7773722d382f4809d650<emphasis>29c</emphasis>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	233 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	234 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	235
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	236 <para>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	237 Кэшируемый ответ сначала записывается во временный файл, а потом этот файл
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	238 переименовывается.
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	239 Начиная с версии 0.8.9, временные файлы и кэш
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	240 могут располагаться на разных файловых системах, но нужно учитывать,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	241 что в этом случае вместо дешёвой операции переименовывания в пределах
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	242 одной файловой системы файл копируется с одной файловой системы на другую.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	243 Поэтому лучше, если кэш будет находиться на той же файловой
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	244 системе, что и каталог с временными файлами, задаваемый директивой
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	245 <link id="proxy_temp_path"/> для данного location.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	246 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	247
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	248 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	249 Кроме того, все активные ключи и информация о данных хранятся в разделяемой
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	250 памяти — зоне, <value>имя</value> и <value>размер</value> которой
fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	251 задаются параметром <literal>keys_zone</literal>.
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	252 Если к данным кэша не обращаются в течение времени, заданного параметром
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	253 <literal>inactive</literal>, то данные удаляются, независимо от их свежести.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	254 По умолчанию <literal>inactive</literal> равен 10 минутам.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	255 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	256
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	257 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	258 Специальный процесс “cache manager” следит за максимальным размером кэша,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	259 заданным параметром <literal>max_size</literal>, и при превышении
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	260 его размеров удаляет самые невостребованные данные.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	261 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	262
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	263 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	264
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	265
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	266 <directive name="proxy_cache_use_stale">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	267 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	268 <literal>error</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	269 <literal>timeout</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	270 <literal>invalid_header</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	271 <literal>updating</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	272 <literal>http_500</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	273 <literal>http_502</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	274 <literal>http_503</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	275 <literal>http_504</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	276 <literal>http_404</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	277 <literal>off</literal>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	278 ...</syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	279 <default>off</default>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	280 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	281 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	282 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	283
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	284 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	285 Определяет, в каких случаях можно использовать
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	286 устаревший закэшированный ответ, если при работе с проксированным
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	287 сервером возникла ошибка.
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	288 Параметры директивы совпадают с параметрами
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	289 директивы <link id="proxy_next_upstream"/>.
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	290 Кроме того, дополнительный параметр <literal>updating</literal>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	291 разрешает использовать устаревший закэшированный ответ,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	292 если на данный момент он уже обновляется.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	293 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	294
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	295 </directive>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	296
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	297
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	298 <directive name="proxy_cache_valid">
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	299 <syntax>[<value>код</value> ...] <value>время</value></syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	300 <default/>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	301 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	302 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	303 <context>location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	304
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	305 <para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	306 Задаёт время кэширования для разных кодов ответа.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	307 Например, директивы
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	308 <example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	309 proxy_cache_valid 200 302 10m;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	310 proxy_cache_valid 404 1m;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	311 </example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	312 задают время кэширования 10 минут для ответов с кодами 200 и 302,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	313 и 1 минуту для ответов с кодом 404.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	314 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	315
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	316 <para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	317 Если указано только <value>время</value> кэширования,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	318 <example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	319 proxy_cache_valid 5m;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	320 </example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	321 то кэшируются только ответы 200, 301 и 302.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	322 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	323
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	324 <para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	325 Кроме того, можно кэшировать любые ответы с помощью параметра
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	326 <literal>any</literal>:
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	327 <example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	328 proxy_cache_valid 200 302 10m;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	329 proxy_cache_valid 301 1h;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	330 proxy_cache_valid any 1m;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	331 </example>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	332 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	333
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	334 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	335
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	336
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	337 <directive name="proxy_connect_timeout">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	338 <syntax><value>время</value></syntax>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	339 <default>60s</default>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	340 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	341 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	342 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	343
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	344 <para>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	345 Задаёт таймаут для установления соединения с проксированным сервером.
fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	346 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	347 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	348
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	349 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	350
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	351
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	352 <directive name="proxy_hide_header">
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	353 <syntax><value>поле</value></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	354 <default/>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	355 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	356 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	357 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	358
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	359 <para>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	360 По умолчанию
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	361 nginx не передаёт клиенту поля заголовка <header>Date</header>,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	362 <header>Server</header>, <header>X-Pad</header> и
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	363 <header>X-Accel-...</header> из ответа проксированного сервера.
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	364 Директива <literal>proxy_hide_header</literal> задаёт дополнительные поля,
fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	365 которые не будут передаваться.
291 fd85955f31aa Removed a questionable word. Ruslan Ermilov <ru@nginx.com> parents: 279 diff changeset	366 Если же передачу полей нужно разрешить, можно воспользоваться
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	367 директивой <link id="proxy_pass_header"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	368 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	369
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	370 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	371
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	372
316 1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	373 <directive name="proxy_http_version">
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	374 <syntax><literal>1.0</literal> \| <literal>1.1</literal></syntax>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	375 <default>1.0</default>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	376 <context>http</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	377 <context>server</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	378 <context>location</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	379 <appeared-in>1.1.4</appeared-in>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	380
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	381 <para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	382 Задаёт версию протокола HTTP для проксирования.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	383 По умолчанию используется версия 1.0.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	384 Для работы
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	385 <link doc="ngx_http_upstream_module.xml" id="keepalive">постоянных
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	386 соединений</link> рекомендуется версия 1.1.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	387 </para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	388
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	389 </directive>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	390
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version", Ruslan Ermilov <ru@nginx.com> parents: 310 diff changeset	391
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	392 <directive name="proxy_ignore_client_abort">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	393 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	394 <default>off</default>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	395 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	396 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	397 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	398
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	399 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	400 Определяет, закрывать ли соединение с проксированным сервером
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	401 в случае, если клиент закрыл соединение, не дождавшись ответа.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	402 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	403
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	404 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	405
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	406
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	407 <directive name="proxy_ignore_headers">
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	408 <syntax><value>поле</value> ...</syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	409 <default/>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	410 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	411 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	412 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	413
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	414 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	415 Запрещает обработку некоторых полей заголовка из ответа проксированного сервера.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	416 В директиве можно указать поля <header>X-Accel-Redirect</header>,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	417 <header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6),
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	418 <header>X-Accel-Buffering</header> (1.1.6),
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	419 <header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	420 <header>Cache-Control</header> и <header>Set-Cookie</header> (0.8.44).
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	421 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	422
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	423 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	424
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	425
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	426 <directive name="proxy_intercept_errors">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	427 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	428 <default>off</default>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	429 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	430 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	431 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	432
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	433 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	434 Определяет, передавать ли клиенту проксированные ответы с кодом
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	435 больше либо равным 400, или же перенаправлять их на обработку nginx'у с помощью
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	436 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	437 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	438
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	439 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	440
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	441
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	442 <directive name="proxy_next_upstream">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	443 <syntax>
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	444 <literal>error</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	445 <literal>timeout</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	446 <literal>invalid_header</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	447 <literal>http_500</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	448 <literal>http_502</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	449 <literal>http_503</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	450 <literal>http_504</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	451 <literal>http_404</literal> \|
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	452 <literal>off</literal>
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	453 ...</syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	454 <default>error timeout</default>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	455 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	456 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	457 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	458
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	459 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	460 Определяет, в каких случаях запрос будет передан следующему серверу:
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	461 <list type="tag">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	462
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	463 <tag-name><literal>error</literal></tag-name>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	464 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	465 чтения заголовка ответа сервера;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	466
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	467 <tag-name><literal>timeout</literal></tag-name>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	468 <tag-desc>произошёл таймаут во время соединения с сервером,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	469 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	470
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	471 <tag-name><literal>invalid_header</literal></tag-name>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	472 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	473
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	474 <tag-name><literal>http_500</literal></tag-name>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	475 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	476
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	477 <tag-name><literal>http_502</literal></tag-name>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	478 <tag-desc>сервер вернул ответ с кодом 502;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	479
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	480 <tag-name><literal>http_503</literal></tag-name>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	481 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	482
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	483 <tag-name><literal>http_504</literal></tag-name>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	484 <tag-desc>сервер вернул ответ с кодом 504;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	485
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	486 <tag-name><literal>http_404</literal></tag-name>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	487 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	488
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	489 <tag-name><literal>off</literal></tag-name>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	490 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	491
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	492 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	493 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	494
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	495 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	496 Необходимо понимать, что передача запроса следующему серверу возможна
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	497 только при условии, что клиенту ещё ничего не передавалось.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	498 То есть, если ошибка или таймаут возникли в середине передачи ответа,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	499 то исправить это уже невозможно.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	500 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	501
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	502 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	503
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	504
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	505 <directive name="proxy_no_cache">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	506 <syntax><value>строка</value> ...</syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	507 <default/>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	508 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	509 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	510 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	511
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	512 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	513 Задаёт условия, при которых ответ не будет сохраняться в кэш.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	514 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	515 то ответ не будет сохранён:
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	516 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	517 proxy_no_cache $cookie_nocache $arg_nocache$arg_comment;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	518 proxy_no_cache $http_pragma $http_authorization;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	519 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	520 Можно использовать совместно с директивой <link id="proxy_cache_bypass"/>.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	521 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	522
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	523 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	524
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	525
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	526 <directive name="proxy_pass">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	527 <syntax><value>URL</value></syntax>
99 1d315ef37215 The case <default/> is now language-agnostic. Ruslan Ermilov <ru@nginx.com> parents: 98 diff changeset	528 <default/>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	529 <context>location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	530 <context>if в location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	531 <context>limit_except</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	532
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	533 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	534 Задаёт адрес проксируемоего сервера и URI, на который
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	535 будет отображаться location.
296 95e5ceac093d Wording and punctuation. Ruslan Ermilov <ru@nginx.com> parents: 291 diff changeset	536 Адрес может быть указан в виде доменного имени или адреса, и порта, например,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	537 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	538 proxy_pass http://localhost:8000/uri/;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	539 </example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	540 или в виде пути UNIX-сокета:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	541 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	542 proxy_pass http://unix:/tmp/backend.socket:/uri/;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	543 </example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	544 путь указан после слова “<literal>unix</literal>”
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	545 и заключён между двумя двоеточиями.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	546 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	547
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	548 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	549 Если доменному имени соответствует несколько адресов, то все они будут
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	550 использоваться по очереди (round-robin).
296 95e5ceac093d Wording and punctuation. Ruslan Ermilov <ru@nginx.com> parents: 291 diff changeset	551 И, кроме того, адрес может быть
135 edf8c90f8085 Renamed ngx_http_upstream to ngx_http_upstream_module. Ruslan Ermilov <ru@nginx.com> parents: 110 diff changeset	552 <link doc="ngx_http_upstream_module.xml">группой серверов</link>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	553 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	554
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	555 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	556 При передаче запроса серверу часть URI, соответствующая location,
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	557 заменяется на URI, указанный в директиве <literal>proxy_pass</literal>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	558 Но из этого правила есть два исключения, в которых нельзя определить
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	559 заменяемый location:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	560 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	561
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	562 <listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	563 если location задан регулярным выражением;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	564 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	565
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	566 <listitem>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	567 если внутри проксируемого location с помощью директивы
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	568 <link doc="ngx_http_rewrite_module.xml" id="rewrite"/> изменяется
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	569 URI, и именно с этой конфигурацией будет обрабатываться запрос
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	570 (<literal>break</literal>):
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	571 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	572 location /name/ {
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	573 rewrite /name/([^/]+) /users?name=$1 break;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	574 proxy_pass http://127.0.0.1;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	575 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	576 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	577 Для этих случаев URI передаётся без отображения.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	578 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	579
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	580 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	581 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	582
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	583 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	584 Кроме того, можно указать, чтобы URI запроса передавался в том же виде,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	585 в каком его прислал клиент, а не в обработанном виде.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	586 Во время обработки
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	587 <list type="bullet">
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	588
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	589 <listitem>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	590 два и более слэшей заменяются на один: “//” — “/”;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	591 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	592
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	593 <listitem>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	594 убираются ссылки на текущий каталог: “/./” — “/”;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	595 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	596
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	597 <listitem>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	598 убираются ссылки на предыдущий каталог: “/dir/../” — “/”.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	599 </listitem>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	600
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	601 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	602 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	603
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	604 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	605 Если на сервер нужно передать URI в необработанном виде, то для этого
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	606 в директиве <literal>proxy_pass</literal> нужно указать URL сервера без URI:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	607 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	608 location /some/path/ {
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	609 proxy_pass http://127.0.0.1;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	610 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	611 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	612 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	613
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	614 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	615 Имя сервера, его порт и передаваемый URI можно также полностью задать
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	616 с помощью переменных:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	617 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	618 proxy_pass http://$host$uri;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	619 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	620 или так:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	621 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	622 proxy_pass $request;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	623 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	624 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	625
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	626 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	627 В этом случае имя сервера ищется среди описанных
135 edf8c90f8085 Renamed ngx_http_upstream to ngx_http_upstream_module. Ruslan Ermilov <ru@nginx.com> parents: 110 diff changeset	628 <link doc="ngx_http_upstream_module.xml">групп серверов</link>
79 0a45870d0160 Fixed cross-document links to use doc and id. Maxim Dounin <mdounin@mdounin.ru> parents: 76 diff changeset	629 и если не найдено, то определяется с помощью
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	630 <link doc="ngx_http_core_module.xml" id="resolver"/>'а.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	631 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	632
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	633 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	634
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	635
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	636 <directive name="proxy_pass_header">
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	637 <syntax><value>поле</value></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	638 <default/>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	639 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	640 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	641 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	642
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	643 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	644 Разрешает передавать от проксируемого сервера клиенту
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	645 <link id="proxy_hide_header">запрещённые для передачи</link> поля заголовка.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	646 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	647
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	648 </directive>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	649
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	650
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	651 <directive name="proxy_read_timeout">
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	652 <syntax><value>время</value></syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	653 <default>60s</default>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	654 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	655 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	656 <context>location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	657
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	658 <para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	659 Задаёт таймаут при чтении ответа проксированного сервера.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	660 Таймаут устанавливается не на всю передачу ответа,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	661 а только между двумя операциями чтения.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	662 Если по истечении этого времени проксируемый сервер ничего не передаст,
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	663 соединение закрывается.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	664 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	665
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	666 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	667
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	668
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	669 <directive name="proxy_redirect">
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	670 <syntax><literal>default</literal></syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	671 <syntax><literal>off</literal></syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	672 <syntax><value>перенаправление</value> <value>замена</value></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	673 <default>default</default>
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	674 <context>http</context>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	675 <context>server</context>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	676 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	677
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	678 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	679 Задаёт текст, который нужно изменить в полях заголовка
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	680 <header>Location</header> и <header>Refresh</header> в ответе
e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	681 проксируемого сервера.
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	682 Предположим, проксируемый сервер вернул поле заголовка
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	683 “<literal>Location: http://localhost:8000/two/some/uri/</literal>”.
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	684 Директива
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	685 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	686 proxy_redirect http://localhost:8000/two/ http://frontend/one/;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	687 </example>
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	688 перепишет эту строку в виде
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	689 “<literal>Location: http://frontend/one/some/uri/</literal>”.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	690 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	691
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	692 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	693 В заменяемой строке можно не указывать имя сервера:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	694 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	695 proxy_redirect http://localhost:8000/two/ /;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	696 </example>
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	697 тогда будет подставлено основное имя сервера и порт, если он отличен от 80.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	698 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	699
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	700 <para>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	701 Стандартная замена, задаваемая параметром <literal>default</literal>,
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	702 использует параметры директив
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	703 <link doc="ngx_http_core_module.xml" id="location"/> и
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	704 <link id="proxy_pass"/>.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	705 Поэтому две нижеприведённые конфигурации одинаковы:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	706 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	707 location /one/ {
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	708 proxy_pass http://upstream:port/two/;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	709 proxy_redirect default;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	710 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	711
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	712 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	713 location /one/ {
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	714 proxy_pass http://upstream:port/two/;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	715 proxy_redirect http://upstream:port/two/ /one/;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	716 </example>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	717 Параметр <literal>default</literal> недопустим, если в <link id="proxy_pass"/>
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	718 используются переменные.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	719 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	720
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	721 <para>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	722 В строке <value>замена</value> можно использовать переменные:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	723 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	724 proxy_redirect http://localhost:8000/ http://$host:$server_port/;
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	725 </example>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	726 </para>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	727
e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	728 <para>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	729 В строке <value>перенаправление</value> тоже можно использовать (1.1.11)
fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	730 переменные:
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	731 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	732 proxy_redirect http://$proxy_host:8000/ /;
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	733 </example>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	734 </para>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	735
e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	736 <para>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	737 Директиву также можно задать (1.1.11) при помощи регулярных выражений.
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	738 При этом <value>перенаправление</value> должно начинаться либо с символа
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	739 “<literal>~</literal>”, если при сравнении следует учитывать регистр символов,
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	740 либо с символов “<literal>~*</literal>”, если регистр символов учитывать
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	741 не нужно.
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	742 Регулярное выражение может содержать именованные и позиционные выделения,
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	743 а <value>замена</value> ссылаться на них:
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	744 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	745 proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2;
a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	746 proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	747 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	748 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	749
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	750 <para>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	751 Директив <literal>proxy_redirect</literal> может быть несколько:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	752 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	753 proxy_redirect default;
a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	754 proxy_redirect http://localhost:8000/ /;
a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	755 proxy_redirect http://www.example.com/ /;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	756 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	757 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	758
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	759 <para>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	760 Параметр <literal>off</literal> запрещает все директивы
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	761 <literal>proxy_redirect</literal>
238 e33fc8541217 - "proxy_redirect" supports variables in the first parameter, Ruslan Ermilov <ru@nginx.com> parents: 222 diff changeset	762 на данном уровне:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	763 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	764 proxy_redirect off;
a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	765 proxy_redirect default;
a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	766 proxy_redirect http://localhost:8000/ /;
a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	767 proxy_redirect http://www.example.com/ /;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	768 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	769 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	770
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	771 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	772 С помощью этой директивы можно также добавлять имя хоста к относительным
256 c78b2d6fe261 Use another term for "redirect". Ruslan Ermilov <ru@nginx.com> parents: 238 diff changeset	773 перенаправлениям, выдаваемым проксируемым сервером:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	774 <example>
351 a4fa80755eab Consistently strip initial offset in examples. Ruslan Ermilov <ru@nginx.com> parents: 316 diff changeset	775 proxy_redirect / /;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	776 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	777 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	778
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	779 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	780
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	781
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	782 <directive name="proxy_send_timeout">
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	783 <syntax><value>время</value></syntax>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	784 <default>60s</default>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	785 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	786 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	787 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	788
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	789 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	790 Задаёт таймаут при передаче запроса проксированному серверу.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	791 Таймаут устанавливается не на всю передачу запроса,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	792 а только между двумя операциями записи.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	793 Если по истечении этого времени проксируемый сервер не примет новых данных,
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	794 соединение закрывается.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	795 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	796
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	797 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	798
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	799
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	800 <directive name="proxy_set_header">
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	801 <syntax><value>поле</value> <value>значение</value></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	802 <default>Host $proxy_host</default>
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	803 <default>Connection close</default>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	804 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	805 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	806 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	807
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	808 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	809 Позволяет переопределять или добавлять поля заголовка запроса,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	810 передаваемые проксируемому серверу.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	811 В качестве значения можно использовать текст, переменные и их комбинации.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	812 Директивы наследуются с предыдущего уровня при условии, что на данном
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	813 уровне не описаны свои директивы <literal>proxy_set_header</literal>.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	814 По умолчанию переопределяются только два поля:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	815 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	816 proxy_set_header Host $proxy_host;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	817 proxy_set_header Connection close;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	818 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	819 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	820
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	821 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	822 Неизменённое поле заголовка запроса <header>Host</header> можно передать так:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	823 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	824 proxy_set_header Host $http_host;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	825 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	826 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	827
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	828 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	829 Однако, если это поле отсутствует в заголовке запроса клиента, то ничего
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	830 передаваться не будет.
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	831 В этом случае лучше воспользоваться переменной <var>$host</var>—её
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	832 значение равно имени сервера в поле <header>Host</header>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	833 заголовка запроса, или же основному имени сервера, если поля нет:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	834 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	835 proxy_set_header Host $host;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	836 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	837 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	838
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	839 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	840 Кроме того, можно передать имя сервера вместе с портом проксируемого сервера:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	841 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	842 proxy_set_header Host $host:$proxy_port;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	843 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	844 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	845
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	846 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	847 Если значение поля заголовка — пустая строка, то поле вообще
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	848 не будет передаваться проксируемому серверу:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	849 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	850 proxy_set_header Accept-Encoding "";
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	851 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	852 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	853
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	854 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	855
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	856
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	857 <directive name="proxy_ssl_session_reuse">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	858 <syntax><literal>on</literal> \| <literal>off</literal></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	859 <default>on</default>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	860 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	861 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	862 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	863
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	864 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	865 Определяет, использовать ли повторно SSL-сессии при
364 bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	866 работе с проксированным сервером.
bb51d3e17dd0 Style fixed. Ruslan Ermilov <ru@nginx.com> parents: 351 diff changeset	867 Если в логах появляются ошибки
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	868 “<literal>SSL3_GET_FINISHED:digest check failed</literal>”,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	869 то можно попробовать выключить
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	870 повторное использование сессий.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	871 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	872
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	873 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	874
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	875
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	876 <directive name="proxy_store">
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	877 <syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	878 <literal>on</literal> \|
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	879 <literal>off</literal> \|
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	880 <value>строка</value></syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	881 <default>off</default>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	882 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	883 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	884 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	885
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	886 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	887 Разрешает сохранение на диск файлов.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	888 Параметр <literal>on</literal> сохраняет файлы в соответствии с путями,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	889 указанными в директивах
106 56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	890 <link doc="ngx_http_core_module.xml" id="alias"/> или
56457a474903 If text of the link is not provided, the @id is used. Ruslan Ermilov <ru@nginx.com> parents: 102 diff changeset	891 <link doc="ngx_http_core_module.xml" id="root"/>.
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	892 Параметр <literal>off</literal> запрещает сохранение файлов.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	893 Кроме того, имя файла можно задать явно с помощью строки с переменными:
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	894 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	895 proxy_store /data/www$original_uri;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	896 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	897 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	898
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	899 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	900 Время изменения файлов выставляется согласно полученному полю
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	901 <header>Last-Modified</header> в заголовке ответа.
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	902 Ответ сначала записывается во временный файл, а потом этот файл
fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	903 переименовывается.
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	904 Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	905 могут располагаться на разных файловых системах, но нужно учитывать,
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	906 что в этом случае вместо дешёвой операции переименовывания в пределах
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	907 одной файловой системы файл копируется с одной файловой системы на другую.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	908 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	909 системе, что и каталог с временными файлами, задаваемый директивой
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	910 <link id="proxy_temp_path"/> для данного location.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	911 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	912
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	913 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	914 Директиву можно использовать для создания локальных копий статических
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	915 неизменяемых файлов, например, так:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	916 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	917 location /images/ {
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	918 root /data/www;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	919 open_file_cache_errors off;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	920 error_page 404 = /fetch$uri;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	921 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	922
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	923 location /fetch/ {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	924 internal;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	925
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	926 proxy_pass http://backend/;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	927 proxy_store on;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	928 proxy_store_access user:rw group:rw all:r;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	929 proxy_temp_path /data/temp;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	930
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	931 alias /data/www/;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	932 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	933 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	934 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	935
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	936 <para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	937 или так:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	938 <example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	939 location /images/ {
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	940 root /data/www;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	941 error_page 404 = @fetch;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	942 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	943
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	944 location @fetch {
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	945 internal;
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	946
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	947 proxy_pass http://backend;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	948 proxy_store on;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	949 proxy_store_access user:rw group:rw all:r;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	950 proxy_temp_path /data/temp;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	951
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	952 root /data/www;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	953 }
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	954 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	955 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	956
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	957 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	958
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	959
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	960 <directive name="proxy_store_access">
271 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 256 diff changeset	961 <syntax><value>пользователи</value>:<value>права</value> ...</syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	962 <default>user:rw</default>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	963 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	964 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	965 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	966
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	967 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	968 Задаёт права доступа для создаваемых файлов и каталогов, например,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	969 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	970 proxy_store_access user:rw group:rw all:r;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	971 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	972 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	973
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	974 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	975 Если заданы какие-либо права для <literal>group</literal> или
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	976 <literal>all</literal>, то права для <literal>user</literal>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	977 указывать необязательно:
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	978 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	979 proxy_store_access group:rw all:r;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	980 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	981 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	982
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	983 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	984
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	985
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	986 <directive name="proxy_temp_path">
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	987 <syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	988 <value>путь</value>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	989 [<value>уровень1</value>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	990 [<value>уровень2</value>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	991 [<value>уровень3</value>]]]</syntax>
102 c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>. Ruslan Ermilov <ru@nginx.com> parents: 99 diff changeset	992 <default>proxy_temp</default>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	993 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	994 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	995 <context>location</context>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	996
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	997 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	998 Задаёт имя каталога для хранения временных файлов,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	999 полученных от другого сервера.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1000 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1001 Например, при такой конфигурации
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1002 <example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1003 proxy_temp_path /spool/nginx/proxy_temp 1 2;
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1004 </example>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1005 временный файл будет следующего вида:
98 a10bc0cb0a6a Whitespace cleanup. Ruslan Ermilov <ru@nginx.com> parents: 97 diff changeset	1006 <example>
279 fa1213cffc34 Revision. Ruslan Ermilov <ru@nginx.com> parents: 273 diff changeset	1007 /spool/nginx/proxy_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1008 </example>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1009 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1010
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1011 </directive>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1012
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1013 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1014
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1015
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1016 <section id="variables" name="Встроенные переменные">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1017
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1018 <para>
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1019 В модуле <literal>ngx_http_proxy_module</literal> есть встроенные переменные,
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1020 которые можно использовать для формирования заголовков с помощью директивы
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1021 <link id="proxy_set_header"/>:
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1022 <list type="tag">
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1023
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1024 <tag-name><var>$proxy_host</var></tag-name>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1025 <tag-desc>имя проксируемого хоста и порт;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1026
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1027 <tag-name><var>$proxy_port</var></tag-name>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1028 <tag-desc>порт проксируемого хоста;</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1029
273 44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1030 <tag-name><var>$proxy_add_x_forwarded_for</var></tag-name>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1031 <tag-desc>поле заголовка запроса клиента <header>X-Forwarded-For</header>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1032 и добавленная к нему через запятую переменная <var>$remote_addr</var>.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1033 Если же поля <header>X-Forwarded-For</header> в заголовке запроса клиента нет,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1034 то переменная <var>$proxy_add_x_forwarded_for</var>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links, Ruslan Ermilov <ru@nginx.com> parents: 271 diff changeset	1035 равна переменной <var>$remote_addr</var>.</tag-desc>
76 4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1036 </list>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1037 </para>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1038
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1039 </section>
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1040
4a4caa566120 Russian documentation import. Maxim Dounin <mdounin@mdounin.ru> parents: diff changeset	1041 </module>

Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_proxy_module.xml @ 364:bb51d3e17dd0