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

Revision.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 27 Dec 2011 09:55:41 +0000
parents 44ab4026d9f5
children fd85955f31aa
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
160 <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
161 <syntax><value>число</value></syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
162 <default>1</default>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
163 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
164 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
165 <context>location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
166
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
167 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
168 Задаёт <value>число</value> запросов, после которого ответ будет закэширован.
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
169 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
170
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
171 </directive>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
172
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
173
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
174 <directive name="proxy_cache_path">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
175 <syntax>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
176 <value>путь</value>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
177 [<literal>levels</literal>=<value>уровни</value>]
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
178 <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
179 [<literal>inactive</literal>=<value>время</value>]
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
180 [<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
181 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
182 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
183
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
184 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
185 Задаёт путь и другие параметры кэша.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
186 Данные кэша хранятся в файлах.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
187 Ключом и именем файла в кэше является результат функции MD5
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
188 от проксированного URL.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
189 Параметр <literal>levels</literal> задаёт уровни иерархии кэша,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
190 например, при использовании
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
191 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
192 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
193 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
194 имена файлов в кэше будут такого вида:
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
195 <example>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
196 /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
197 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
198 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
199
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
200 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
201 Кэшируемый ответ сначала записывается во временный файл, а потом этот файл
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
202 переименовывается. Начиная с версии 0.8.9, временные файлы и кэш
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
203 могут располагаться на разных файловых системах, но нужно учитывать,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
204 что в этом случае вместо дешёвой операции переименовывания в пределах
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
205 одной файловой системы файл копируется с одной файловой системы на другую.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
206 Поэтому лучше, если кэш будет находиться на той же файловой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
207 системе, что и каталог с временными файлами, задаваемый директивой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
208 <link id="proxy_temp_path"/> для данного location.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
209 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
210
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
211 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
212 Кроме того, все активные ключи и информация о данных хранятся в разделяемой
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
213 памяти — зоне, <value>имя</value> и <value>размер</value> которой
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
214 задаются параметром <literal>keys_zone</literal>.
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
215 Если к данным кэша не обращаются в течение времени, заданного параметром
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
216 <literal>inactive</literal>, то данные удаляются, независимо от их свежести.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
217 По умолчанию <literal>inactive</literal> равен 10 минутам.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
218 </para>
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 Специальный процесс “cache manager” следит за максимальным размером кэша,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
222 заданным параметром <literal>max_size</literal>, и при превышении
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
223 его размеров удаляет самые невостребованные данные.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
224 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
225
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
226 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
227
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
228
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
229 <directive name="proxy_cache_use_stale">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
230 <syntax>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
231 <literal>error</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
232 <literal>timeout</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
233 <literal>invalid_header</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
234 <literal>updating</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
235 <literal>http_500</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
236 <literal>http_502</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
237 <literal>http_503</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
238 <literal>http_504</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
239 <literal>http_404</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
240 <literal>off</literal>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
241 ...</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
242 <default>off</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
243 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
244 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
245 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
246
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
247 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
248 Определяет, в каких случаях можно использовать
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
249 устаревший закэшированный ответ, если при работе с проксированным
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
250 сервером возникла ошибка. Параметры директивы совпадают с параметрами
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
251 директивы <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
252 Кроме того, дополнительный параметр <literal>updating</literal>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
253 разрешает использовать устаревший закэшированный ответ,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
254 если на данный момент он уже обновляется.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
255 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
256
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
257 </directive>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
258
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
259
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
260 <directive name="proxy_cache_valid">
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
261 <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
262 <default/>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
263 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
264 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
265 <context>location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
266
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
267 <para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
268 Задаёт время кэширования для разных кодов ответа.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
269 Например, директивы
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
270 <example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
271 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
272 proxy_cache_valid 404 1m;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
273 </example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
274 задают время кэширования 10 минут для ответов с кодами 200 и 302,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
275 и 1 минуту для ответов с кодом 404.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
276 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
277
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
278 <para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
279 Если указано только <value>время</value> кэширования,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
280 <example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
281 proxy_cache_valid 5m;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
282 </example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
283 то кэшируются только ответы 200, 301 и 302.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
284 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
285
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
286 <para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
287 Кроме того, можно кэшировать любые ответы с помощью параметра
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
288 <literal>any</literal>:
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
289 <example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
290 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
291 proxy_cache_valid 301 1h;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
292 proxy_cache_valid any 1m;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
293 </example>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
294 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
295
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
296 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
297
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
298
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
299 <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
300 <syntax><value>время</value></syntax>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
301 <default>60s</default>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
302 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
303 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
304 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
305
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
306 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
307 Задаёт таймаут для установления соединения с проксированным сервером.
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
308 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
309 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
310
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
311 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
312
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
313
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
314 <directive name="proxy_hide_header">
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
315 <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
316 <default/>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
317 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
318 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
319 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
320
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
321 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
322 По умолчанию
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
323 nginx не передаёт клиенту поля заголовка <header>Date</header>,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
324 <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
325 <header>X-Accel-...</header> из ответа проксированного сервера.
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
326 Директива <literal>proxy_hide_header</literal> задаёт дополнительные поля,
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
327 которые не будут передаваться.
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
328 Если же передачу полей нужно напротив разрешить, можно воспользоваться
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
329 директивой <link id="proxy_pass_header"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
330 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
331
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
332 </directive>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
335 <directive name="proxy_ignore_client_abort">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
336 <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
337 <default>off</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
338 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
339 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
340 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
341
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
342 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
343 Определяет, закрывать ли соединение с проксированным сервером
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
344 в случае, если клиент закрыл соединение, не дождавшись ответа.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
345 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
346
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
347 </directive>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
350 <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
351 <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
352 <default/>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
353 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
354 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
355 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
356
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
357 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
358 Запрещает обработку некоторых полей заголовка из ответа проксированного сервера.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
359 В директиве можно указать поля <header>X-Accel-Redirect</header>,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
360 <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
361 <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
362 <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
363 <header>Cache-Control</header> и <header>Set-Cookie</header> (0.8.44).
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
364 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
365
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
366 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
367
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
368
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
369 <directive name="proxy_intercept_errors">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
370 <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
371 <default>off</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
372 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
373 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
374 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
375
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
376 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
377 Определяет, передавать ли клиенту проксированные ответы с кодом
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
378 больше либо равным 400, или же перенаправлять их на обработку nginx'у с помощью
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
379 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
380 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
381
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
382 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
383
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
384
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
385 <directive name="proxy_next_upstream">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
386 <syntax>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
387 <literal>error</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
388 <literal>timeout</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
389 <literal>invalid_header</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
390 <literal>http_500</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
391 <literal>http_502</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
392 <literal>http_503</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
393 <literal>http_504</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
394 <literal>http_404</literal> |
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
395 <literal>off</literal>
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
396 ...</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
397 <default>error timeout</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
398 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
399 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
400 <context>location</context>
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>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
403 Определяет, в каких случаях запрос будет передан следующему серверу:
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
404 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
405
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
406 <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
407 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
408 чтения заголовка ответа сервера;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
409
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
410 <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
411 <tag-desc>произошёл таймаут во время соединения с сервером,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
412 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
413
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
414 <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
415 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
416
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
417 <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
418 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
419
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
420 <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
421 <tag-desc>сервер вернул ответ с кодом 502;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
422
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
423 <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
424 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
425
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
426 <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
427 <tag-desc>сервер вернул ответ с кодом 504;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
428
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
429 <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
430 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
431
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
432 <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
433 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
434
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
435 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
436 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
437
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
438 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
439 Необходимо понимать, что передача запроса следующему серверу возможна
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 то исправить это уже невозможно.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
443 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
444
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
445 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
446
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
447
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
448 <directive name="proxy_no_cache">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
449 <syntax><value>строка</value> ...</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
450 <default/>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
451 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
452 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
453 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
454
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
455 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
456 Задаёт условия, при которых ответ не будет сохраняться в кэш.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
457 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
458 то ответ не будет сохранён:
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
459 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
460 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
461 proxy_no_cache $http_pragma $http_authorization;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
462 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
463 Можно использовать совместно с директивой <link id="proxy_cache_bypass"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
464 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
465
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
466 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
467
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
468
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
469 <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
470 <syntax><value>URL</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
471 <default/>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
472 <context>location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
473 <context>if в location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
474 <context>limit_except</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
475
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
476 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
477 Задаёт адрес проксируемоего сервера и URI, на который
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
478 будет отображаться location.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
479 Адрес может быть указан в виде доменного имени или адреса и порта, например,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
480 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
481 proxy_pass http://localhost:8000/uri/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
482 </example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
483 или в виде пути UNIX-сокета:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
484 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
485 proxy_pass http://unix:/tmp/backend.socket:/uri/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
486 </example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
487 путь указан после слова “<literal>unix</literal>”
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
488 и заключён между двумя двоеточиями.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
489 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
490
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
491 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
492 Если доменному имени соответствует несколько адресов, то все они будут
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
493 использоваться по очереди (round-robin).
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
494 И, кроме того, адрес можно задать
135
edf8c90f8085 Renamed ngx_http_upstream to ngx_http_upstream_module.
Ruslan Ermilov <ru@nginx.com>
parents: 110
diff changeset
495 <link doc="ngx_http_upstream_module.xml">группой серверов</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
496 </para>
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 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
499 При передаче запроса серверу часть URI, соответствующая location,
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
500 заменяется на URI, указанный в директиве <literal>proxy_pass</literal>.
76
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 заменяемый location:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
503 <list type="bullet">
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 <listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
506 если location задан регулярным выражением;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
507 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
508
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
509 <listitem>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
510 если внутри проксируемого location с помощью директивы
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
511 <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
512 URI, и именно с этой конфигурацией будет обрабатываться запрос
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
513 (<literal>break</literal>):
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
514 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
515 location /name/ {
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
516 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
517 proxy_pass http://127.0.0.1;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
518 }
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 Для этих случаев URI передаётся без отображения.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
521 </listitem>
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 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
524 </para>
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 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
527 Кроме того, можно указать, чтобы URI запроса передавался в том же виде,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
528 в каком его прислал клиент, а не в обработанном виде.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
529 Во время обработки
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
530 <list type="bullet">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
531
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
532 <listitem>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
533 два и более слэшей заменяются на один: “//” — “/”;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
534 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
535
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
536 <listitem>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
537 убираются ссылки на текущий каталог: “/./” — “/”;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
538 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
539
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
540 <listitem>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
541 убираются ссылки на предыдущий каталог: “/dir/../” — “/”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
542 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
543
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
544 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
545 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
546
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
547 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
548 Если на сервер нужно передать URI в необработанном виде, то для этого
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
549 в директиве <literal>proxy_pass</literal> нужно указать URL сервера без URI:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
550 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
551 location /some/path/ {
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
552 proxy_pass http://127.0.0.1;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
553 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
554 </example>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
557 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
558 Имя сервера, его порт и передаваемый URI можно также полностью задать
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
559 с помощью переменных:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
560 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
561 proxy_pass http://$host$uri;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
562 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
563 или так:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
564 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
565 proxy_pass $request;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
566 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
567 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
568
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
569 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
570 В этом случае имя сервера ищется среди описанных
135
edf8c90f8085 Renamed ngx_http_upstream to ngx_http_upstream_module.
Ruslan Ermilov <ru@nginx.com>
parents: 110
diff changeset
571 <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
572 и если не найдено, то определяется с помощью
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
573 <link doc="ngx_http_core_module.xml" id="resolver"/>'а.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
574 </para>
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 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
577
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
578
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
579 <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
580 <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
581 <default/>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
582 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
583 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
584 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
585
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
586 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
587 Разрешает передавать от проксируемого сервера клиенту
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
588 <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
589 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
590
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
591 </directive>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
592
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
593
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
594 <directive name="proxy_read_timeout">
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
595 <syntax><value>время</value></syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
596 <default>60s</default>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
597 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
598 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
599 <context>location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
600
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
601 <para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
602 Задаёт таймаут при чтении ответа проксированного сервера.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
603 Таймаут устанавливается не на всю передачу ответа,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
604 а только между двумя операциями чтения.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
605 Если по истечении этого времени проксируемый сервер ничего не передаст,
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
606 соединение закрывается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
607 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
608
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
609 </directive>
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
612 <directive name="proxy_redirect">
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
613 <syntax><literal>default</literal></syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
614 <syntax><literal>off</literal></syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
615 <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
616 <default>default</default>
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
617 <context>http</context>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
618 <context>server</context>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
619 <context>location</context>
76
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 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
622 Задаёт текст, который нужно изменить в полях заголовка
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
623 <header>Location</header> и <header>Refresh</header> в ответе
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
624 проксируемого сервера.
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
625 Предположим, проксируемый сервер вернул поле заголовка
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
626 “<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
627 Директива
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
628 <example>
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
629 proxy_redirect http://localhost:8000/two/ http://frontend/one/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
630 </example>
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
631 перепишет эту строку в виде
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
632 “<literal>Location: http://frontend/one/some/uri/</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
633 </para>
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 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
636 В заменяемой строке можно не указывать имя сервера:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
637 <example>
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
638 proxy_redirect http://localhost:8000/two/ /;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
639 </example>
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
640 тогда будет подставлено основное имя сервера и порт, если он отличен от 80.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
641 </para>
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>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
644 Стандартная замена, задаваемая параметром <literal>default</literal>,
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
645 использует параметры директив
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
646 <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
647 <link id="proxy_pass"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
648 Поэтому две нижеприведённые конфигурации одинаковы:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
649 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
650 location /one/ {
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
651 proxy_pass http://upstream:port/two/;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
652 proxy_redirect default;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
653 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
654
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
655 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
656 location /one/ {
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
657 proxy_pass http://upstream:port/two/;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
658 proxy_redirect http://upstream:port/two/ /one/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
659 </example>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
660 Параметр <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
661 используются переменные.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
662 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
663
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
664 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
665 В строке <value>замена</value> можно использовать переменные:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
666 <example>
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
667 proxy_redirect http://localhost:8000/ http://$host:$server_port/;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
668 </example>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
669 </para>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
670
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
671 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
672 В строке <value>перенаправление</value> тоже можно использовать (1.1.11)
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
673 переменные:
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
674 <example>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
675 proxy_redirect http://$proxy_host:8000/ /;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
676 </example>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
677 </para>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
678
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
679 <para>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
680 Директиву также можно задать (1.1.11) при помощи регулярных выражений.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
681 При этом <value>перенаправление</value> должно начинаться либо с символа
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
682 “<literal>~</literal>”, если при сравнении следует учитывать регистр символов,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
683 либо с символов “<literal>~*</literal>”, если регистр символов учитывать
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
684 не нужно.
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
685 Регулярное выражение может содержать именованные и позиционные выделения,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
686 а <value>замена</value> ссылаться на них:
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
687 <example>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
688 proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
689 proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
690 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
691 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
692
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
693 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
694 Директив <literal>proxy_redirect</literal> может быть несколько:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
695 <example>
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
696 proxy_redirect default;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
697 proxy_redirect http://localhost:8000/ /;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
698 proxy_redirect http://www.example.com/ /;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
699 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
700 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
701
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
702 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
703 Параметр <literal>off</literal> запрещает все директивы
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
704 <literal>proxy_redirect</literal>
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
705 на данном уровне:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
706 <example>
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
707 proxy_redirect off;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
708 proxy_redirect default;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
709 proxy_redirect http://localhost:8000/ /;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
710 proxy_redirect http://www.example.com/ /;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
711 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
712 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
713
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
714 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
715 С помощью этой директивы можно также добавлять имя хоста к относительным
256
c78b2d6fe261 Use another term for "redirect".
Ruslan Ermilov <ru@nginx.com>
parents: 238
diff changeset
716 перенаправлениям, выдаваемым проксируемым сервером:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
717 <example>
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
718 proxy_redirect / /;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
719 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
720 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
721
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
722 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
723
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
724
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
725 <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
726 <syntax><value>время</value></syntax>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
727 <default>60s</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
728 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
729 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
730 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
731
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
732 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
733 Задаёт таймаут при передаче запроса проксированному серверу.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
734 Таймаут устанавливается не на всю передачу запроса,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
735 а только между двумя операциями записи.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
736 Если по истечении этого времени проксируемый сервер не примет новых данных,
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
737 соединение закрывается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
738 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
739
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
740 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
741
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
742
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
743 <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
744 <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
745 <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
746 <default>Connection close</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
747 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
748 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
749 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
750
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
751 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
752 Позволяет переопределять или добавлять поля заголовка запроса,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
753 передаваемые проксируемому серверу.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
754 В качестве значения можно использовать текст, переменные и их комбинации.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
755 Директивы наследуются с предыдущего уровня при условии, что на данном
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
756 уровне не описаны свои директивы <literal>proxy_set_header</literal>.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
757 По умолчанию переопределяются только два поля:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
758 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
759 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
760 proxy_set_header Connection close;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
761 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
762 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
763
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
764 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
765 Неизменённое поле заголовка запроса <header>Host</header> можно передать так:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
766 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
767 proxy_set_header Host $http_host;
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>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
772 Однако, если это поле отсутствует в заголовке запроса клиента, то ничего
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
773 передаваться не будет. В этом случае лучше воспользоваться переменной
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
774 <var>$host</var>&mdash;её значение равно имени сервера в поле <header>Host</header>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
775 заголовка запроса, или же основному имени сервера, если поля нет:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
776 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
777 proxy_set_header Host $host;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
778 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
779 </para>
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 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
782 Кроме того, можно передать имя сервера вместе с портом проксируемого сервера:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
783 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
784 proxy_set_header Host $host:$proxy_port;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
785 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
786 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
787
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
788 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
789 Если значение поля заголовка — пустая строка, то поле вообще
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
790 не будет передаваться проксируемому серверу:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
791 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
792 proxy_set_header Accept-Encoding "";
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
793 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
794 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
795
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
796 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
797
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 <directive name="proxy_ssl_session_reuse">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
800 <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
801 <default>on</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
802 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
803 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
804 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
805
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
806 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
807 Определяет, использовать ли повторно SSL-сессии при
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
808 работе с проксированным сервером. Если в логах появляются ошибки
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
809 “<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
810 то можно попробовать выключить
76
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 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
813
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
814 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
815
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
816
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
817 <directive name="proxy_store">
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
818 <syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
819 <literal>on</literal> |
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
820 <literal>off</literal> |
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
821 <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
822 <default>off</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
823 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
824 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
825 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
826
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
827 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
828 Разрешает сохранение на диск файлов.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
829 Параметр <literal>on</literal> сохраняет файлы в соответствии с путями,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
830 указанными в директивах
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
831 <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
832 <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
833 Параметр <literal>off</literal> запрещает сохранение файлов.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
834 Кроме того, имя файла можно задать явно с помощью строки с переменными:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
835 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
836 proxy_store /data/www$original_uri;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
837 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
838 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
839
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
840 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
841 Время изменения файлов выставляется согласно полученному полю
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
842 <header>Last-Modified</header> в заголовке ответа.
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
843 Ответ сначала записывается во временный файл, а потом этот файл
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
844 переименовывается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
845 Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
846 могут располагаться на разных файловых системах, но нужно учитывать,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
847 что в этом случае вместо дешёвой операции переименовывания в пределах
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 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
850 системе, что и каталог с временными файлами, задаваемый директивой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
851 <link id="proxy_temp_path"/> для данного location.
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 <para>
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 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
858 location /images/ {
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
859 root /data/www;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
860 open_file_cache_errors off;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
861 error_page 404 = /fetch$uri;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
862 }
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 location /fetch/ {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
865 internal;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
866
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
867 proxy_pass http://backend/;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
868 proxy_store on;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
869 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
870 proxy_temp_path /data/temp;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
871
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
872 alias /data/www/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
873 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
874 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
875 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
876
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
877 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
878 или так:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
879 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
880 location /images/ {
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
881 root /data/www;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
882 error_page 404 = @fetch;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
883 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
884
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
885 location @fetch {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
886 internal;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
887
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
888 proxy_pass http://backend;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
889 proxy_store on;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
890 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
891 proxy_temp_path /data/temp;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
892
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
893 root /data/www;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
894 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
895 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
896 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
897
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
898 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
899
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
900
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
901 <directive name="proxy_store_access">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
902 <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
903 <default>user:rw</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
904 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
905 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
906 <context>location</context>
76
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 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
909 Задаёт права доступа для создаваемых файлов и каталогов, например,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
910 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
911 proxy_store_access user:rw group:rw all:r;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
912 </example>
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 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
916 Если заданы какие-либо права для <literal>group</literal> или
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
917 <literal>all</literal>, то права для <literal>user</literal>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
918 указывать необязательно:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
919 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
920 proxy_store_access group:rw all:r;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
921 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
922 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
923
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
924 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
925
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
926
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
927 <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
928 <syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
929 <value>путь</value>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
930 [<value>уровень1</value>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
931 [<value>уровень2</value>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
932 [<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
933 <default>proxy_temp</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
934 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
935 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
936 <context>location</context>
76
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 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
939 Задаёт имя каталога для хранения временных файлов,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
940 полученных от другого сервера.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
941 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
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 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
944 proxy_temp_path /spool/nginx/proxy_temp 1 2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
945 </example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
946 временный файл будет следующего вида:
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
947 <example>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
948 /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
949 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
950 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
951
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
952 </directive>
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 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
955
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
956
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
957 <section id="variables" name="Встроенные переменные">
76
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 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
960 В модуле <literal>ngx_http_proxy_module</literal> есть встроенные переменные,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
961 которые можно использовать для формирования заголовков с помощью директивы
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
962 <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
963 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
964
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
965 <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
966 <tag-desc>имя проксируемого хоста и порт;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
967
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
968 <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
969 <tag-desc>порт проксируемого хоста;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
970
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
971 <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
972 <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
973 и добавленная к нему через запятую переменная <var>$remote_addr</var>.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
974 Если же поля <header>X-Forwarded-For</header> в заголовке запроса клиента нет,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
975 то переменная <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
976 равна переменной <var>$remote_addr</var>.</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
977 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
978 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
979
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
980 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
981
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
982 </module>