Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_proxy_module.xml @ 273:44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
changed some wording.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Mon, 26 Dec 2011 11:37:06 +0000 |
parents | 4c6d2c614d2c |
children | fa1213cffc34 |
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> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
44 Задаёт размер буфера, в который будет читаться |
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 | 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 не пытается считать весь ответ проксируемого сервера. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
76 Максимальный размер данных, который nginx может принять от сервера, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
77 задаётся директивой <link id="proxy_buffer_size"/>. |
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 | 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> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
91 Задаёт число и размер буферов для одного соединения, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
92 в которые будет читаться ответ, получаемый от проксируемого сервера. |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
93 По умолчанию размер одного буфера равен размеру страницы. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
94 В зависимости от платформы это или 4K, или 8K. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
95 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
96 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
97 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
98 |
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 <directive name="proxy_cache"> |
271 | 101 <syntax><value>зона</value> | <literal>off</literal></syntax> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
102 <default>off</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
103 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
104 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
105 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
106 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
107 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
108 Задаёт зону для кэширования. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
109 Одна и та же зона может использоваться в нескольких местах. |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
110 Параметр <literal>off</literal> запрещает кэширование, унаследованное |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
111 с предыдущего уровня конфигурации. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
112 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
113 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
114 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
115 |
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 <directive name="proxy_cache_bypass"> |
271 | 118 <syntax><value>строка</value> ...</syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
119 <default/> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
120 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
121 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
122 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
123 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
124 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
125 Задаёт условия, при которых ответ не будет браться из кэша. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
126 Если значение хотя бы одного из строковых параметров непустое и не равно “0”, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
127 то ответ не берётся из кэша: |
98 | 128 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
129 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
|
130 proxy_cache_bypass $http_pragma $http_authorization; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
131 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
132 Можно использовать совместно с директивой <link id="proxy_no_cache"/>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
133 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
134 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
135 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
136 |
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 <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
|
139 <syntax><value>строка</value></syntax> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
140 <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
|
141 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
142 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
143 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
144 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
145 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
146 Задаёт ключ для кэширования, например, |
98 | 147 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
148 proxy_cache_key "$host$request_uri $cookie_user"; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
149 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
150 По умолчанию значение директивы близко к строке |
98 | 151 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
152 proxy_cache_key $scheme$proxy_host$uri$is_args$args; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
153 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
154 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
155 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
156 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
157 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
158 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
159 <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
|
160 <syntax><value>число</value></syntax> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
161 <default>1</default> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
162 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
163 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
164 <context>location</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
165 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
166 <para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
167 Задаёт число запросов, после которого ответ будет закэширован. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
168 </para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
169 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
170 </directive> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
171 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
172 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
173 <directive name="proxy_cache_path"> |
271 | 174 <syntax> |
175 <value>путь</value> | |
176 [<literal>levels</literal>=<value>уровни</value>] | |
177 <literal>keys_zone</literal>=<value>название</value>:<value>размер</value> | |
178 [<literal>inactive</literal>=<value>время</value>] | |
179 [<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
|
180 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
181 <context>http</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
182 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
183 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
184 Задаёт путь и другие параметры кэша. |
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 Ключом и именем файла в кэше является результат функции MD5 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
187 от проксированного URL. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
188 Параметр <literal>levels</literal> задаёт уровни иерархии кэша, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
189 например, при использовании |
98 | 190 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
191 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
|
192 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
193 имена файлов в кэше будут такого вида: |
98 | 194 <example> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
195 /data/nginx/cache/<emphasis>c/29</emphasis>/b7f54b2df7773722d382f4809d650<emphasis>29c</emphasis> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
196 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
197 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
198 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
199 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
200 Кэшируемый ответ записывается во временный файл, а потом этот файл |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
201 переименовывается. Начиная с версии 0.8.9, временные файлы и кэш |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
202 могут располагаться на разных файловых системах, но нужно учитывать, |
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 <link id="proxy_temp_path"/> для данного location. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
208 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
209 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
210 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
211 Кроме того, все активные ключи и информация о данных хранятся в разделяемой |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
212 памяти — зоне, имя и размер которой задаётся параметром |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
213 <literal>keys_zone</literal>. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
214 Если к данным кэша не обращаются в течение времени, заданного параметром |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
215 <literal>inactive</literal>, то данные удаляются, независимо от их свежести. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
216 По умолчанию <literal>inactive</literal> равен 10 минутам. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
217 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
218 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
219 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
220 Специальный процесс “cache manager” следит за максимальным размером кэша, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
221 заданным параметром <literal>max_size</literal>, и при превышении |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
222 его размеров удаляет самые невостребованные данные. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
223 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
224 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
225 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
226 |
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 <directive name="proxy_cache_use_stale"> |
271 | 229 <syntax> |
230 <literal>error</literal> | | |
231 <literal>timeout</literal> | | |
232 <literal>invalid_header</literal> | | |
233 <literal>updating</literal> | | |
234 <literal>http_500</literal> | | |
235 <literal>http_502</literal> | | |
236 <literal>http_503</literal> | | |
237 <literal>http_504</literal> | | |
238 <literal>http_404</literal> | | |
239 <literal>off</literal> | |
240 ...</syntax> | |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
241 <default>off</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
242 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
243 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
244 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
245 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
246 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
247 Определяет, в каких случаях можно использовать |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
248 устаревший закэшированный ответ, если при работе с проксированным |
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 директивы <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
|
251 Кроме того, дополнительный параметр <literal>updating</literal> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
252 разрешает использовать устаревший закэшированный ответ, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
253 если на данный момент он уже обновляется. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
254 </para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
255 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
256 </directive> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
257 |
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 <directive name="proxy_cache_valid"> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
260 <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
|
261 <default/> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
262 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
263 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
264 <context>location</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
265 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
266 <para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
267 Задаёт время кэширования для разных кодов ответа. |
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 <example> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
270 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
|
271 proxy_cache_valid 404 1m; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
272 </example> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
273 задают время кэширования 10 минут для ответов с кодами 200 и 302, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
274 и 1 минуту для ответов с кодом 404. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
275 </para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
276 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
277 <para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
278 Если указано только <value>время</value> кэширования, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
279 <example> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
280 proxy_cache_valid 5m; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
281 </example> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
282 то кэшируются только ответы 200, 301 и 302. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
283 </para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
284 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
285 <para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
286 Кроме того, можно кэшировать любые ответы с помощью параметра |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
287 <literal>any</literal>: |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
288 <example> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
289 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
|
290 proxy_cache_valid 301 1h; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
291 proxy_cache_valid any 1m; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
292 </example> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
293 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
294 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
295 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
296 |
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 <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
|
299 <syntax><value>время</value></syntax> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
300 <default>60s</default> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
301 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
302 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
303 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
304 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
305 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
306 Задаёт таймаут для соединения с проксированным сервером. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
307 Необходимо иметь в виду, что этот таймаут не может быть больше 75 секунд. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
308 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
309 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
310 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
311 |
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 <directive name="proxy_hide_header"> |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
314 <syntax><value>имя</value></syntax> |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
315 <default/> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
316 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
317 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
318 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
319 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
320 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
321 nginx не передаёт клиенту поля заголовка <header>Date</header>, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
322 <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
|
323 <header>X-Accel-...</header> из ответа проксированного сервера. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
324 Директива <literal>proxy_hide_header</literal> задаёт дополнительные поля. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
325 Если же поля нужно напротив разрешить, следует воспользоваться |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
326 директивой <link id="proxy_pass_header"/>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
327 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
328 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
329 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
330 |
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 name="proxy_ignore_client_abort"> |
271 | 333 <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
|
334 <default>off</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
335 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
336 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
337 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
338 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
339 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
340 Определяет, закрывать ли соединение с проксированным сервером |
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> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
343 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
344 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
345 |
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 name="proxy_ignore_headers"> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
348 <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
|
349 <default/> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
350 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
351 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
352 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
353 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
354 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
355 Запрещает обработку некоторых полей заголовка из ответа проксированного сервера. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
356 В директиве можно указать поля <header>X-Accel-Redirect</header>, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
357 <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
|
358 <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
|
359 <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
|
360 <header>Cache-Control</header> и <header>Set-Cookie</header> (0.8.44). |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
361 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
362 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
363 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
364 |
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 name="proxy_intercept_errors"> |
271 | 367 <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
|
368 <default>off</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
369 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
370 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
371 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
372 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
373 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
374 Определяет, передавать ли клиенту проксированные ответы с кодом |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
375 больше либо равным 400, или же перенаправлять их на обработку nginx'у с помощью |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
376 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
377 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
378 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
379 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
380 |
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 name="proxy_next_upstream"> |
271 | 383 <syntax> |
384 <literal>error</literal> | | |
385 <literal>timeout</literal> | | |
386 <literal>invalid_header</literal> | | |
387 <literal>http_500</literal> | | |
388 <literal>http_502</literal> | | |
389 <literal>http_503</literal> | | |
390 <literal>http_504</literal> | | |
391 <literal>http_404</literal> | | |
392 <literal>off</literal> | |
393 ...</syntax> | |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
394 <default>error timeout</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
395 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
396 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
397 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
398 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
399 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
400 Определяет, в каких случаях запрос будет передан следующему серверу: |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
401 <list type="tag"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
402 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
403 <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
|
404 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
405 чтения заголовка ответа сервера;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
406 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
407 <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
|
408 <tag-desc>произошёл таймаут во время соединения с сервером, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
409 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
410 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
411 <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
|
412 <tag-desc>сервер вернул пустой или неверный ответ;</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>http_500</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>сервер вернул ответ с кодом 500;</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_502</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>сервер вернул ответ с кодом 502;</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_503</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>сервер вернул ответ с кодом 503;</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_504</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>сервер вернул ответ с кодом 504;</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_404</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>сервер вернул ответ с кодом 404;</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>off</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>запрещает передачу запроса следующему серверу.</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
431 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
432 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
433 </para> |
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 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
436 Необходимо понимать, что передача запроса следующему серверу возможна |
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 То есть, если ошибка или таймаут возникли в середине передачи ответа, |
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 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
441 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
442 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
443 |
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 name="proxy_no_cache"> |
271 | 446 <syntax><value>строка</value> ...</syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
447 <default/> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
448 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
449 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
450 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
451 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
452 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
453 Задаёт условия, при которых ответ не будет сохраняться в кэш. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
454 Если значение хотя бы одного из строковых параметров непустое и не равно “0”, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
455 то ответ не будет сохранён: |
98 | 456 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
457 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
|
458 proxy_no_cache $http_pragma $http_authorization; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
459 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
460 Можно использовать совместно с директивой <link id="proxy_cache_bypass"/>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
461 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
462 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
463 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
464 |
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 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
|
467 <syntax><value>URL</value></syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
468 <default/> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
469 <context>location</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
470 <context>if в location</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
471 <context>limit_except</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
472 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
473 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
474 Задаёт адрес проксируемоего сервера и URI, на который |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
475 будет отображаться location. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
476 Адрес может быть указан в виде доменного имени или адреса и порта, например, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
477 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
478 proxy_pass http://localhost:8000/uri/; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
479 </example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
480 или в виде пути UNIX-сокета: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
481 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
482 proxy_pass http://unix:/tmp/backend.socket:/uri/; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
483 </example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
484 путь указан после слова “<literal>unix</literal>” |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
485 и заключён между двумя двоеточиями. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
486 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
487 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
488 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
489 Если доменному имени соответствует несколько адресов, то все они будут |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
490 использоваться по очереди (round-robin). |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
491 И, кроме того, адрес можно задать |
135
edf8c90f8085
Renamed ngx_http_upstream to ngx_http_upstream_module.
Ruslan Ermilov <ru@nginx.com>
parents:
110
diff
changeset
|
492 <link doc="ngx_http_upstream_module.xml">группой серверов</link>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
493 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
494 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
495 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
496 При передаче запроса серверу часть URI, соответствующая location, |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
497 заменяется на URI, указанный в директиве <literal>proxy_pass</literal>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
498 Но из этого правила есть два исключения, в которых нельзя определить |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
499 заменяемый location: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
500 <list type="bullet"> |
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 <listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
503 если location задан регулярным выражением; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
504 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
505 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
506 <listitem> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
507 если внутри проксируемого location с помощью директивы |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
508 <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
|
509 URI, и именно с этой конфигурацией будет обрабатываться запрос |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
510 (<literal>break</literal>): |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
511 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
512 location /name/ { |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
513 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
|
514 proxy_pass http://127.0.0.1; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
515 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
516 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
517 Для этих случаев URI передаётся без отображения. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
518 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
519 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
520 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
521 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
522 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
523 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
524 Кроме того, можно указать, чтобы URI запроса передавался в том же виде, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
525 в каком его прислал клиент, а не в обработанном виде. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
526 Во время обработки |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
527 <list type="bullet"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
528 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
529 <listitem> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
530 два и более слэшей заменяются на один: “//” — “/”; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
531 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
532 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
533 <listitem> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
534 убираются ссылки на текущий каталог: “/./” — “/”; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
535 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
536 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
537 <listitem> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
538 убираются ссылки на предыдущий каталог: “/dir/../” — “/”. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
539 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
540 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
541 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
542 </para> |
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 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
545 Если на сервер нужно передать URI в необработанном виде, то для этого |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
546 в директиве <literal>proxy_pass</literal> нужно указать URL сервера без URI: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
547 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
548 location /some/path/ { |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
549 proxy_pass http://127.0.0.1; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
550 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
551 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
552 </para> |
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 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
555 Имя сервера, его порт и передаваемый URI можно также полностью задать |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
556 с помощью переменных: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
557 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
558 proxy_pass http://$host$uri; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
559 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
560 или так: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
561 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
562 proxy_pass $request; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
563 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
564 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
565 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
566 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
567 В этом случае имя сервера ищется среди описанных |
135
edf8c90f8085
Renamed ngx_http_upstream to ngx_http_upstream_module.
Ruslan Ermilov <ru@nginx.com>
parents:
110
diff
changeset
|
568 <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
|
569 и если не найдено, то определяется с помощью |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
570 <link doc="ngx_http_core_module.xml" id="resolver"/>'а. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
571 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
572 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
573 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
574 |
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 name="proxy_pass_header"> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
577 <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
|
578 <default/> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
579 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
580 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
581 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
582 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
583 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
584 Разрешает передавать от проксируемого сервера клиенту |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
585 <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
|
586 </para> |
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 </directive> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
589 |
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 name="proxy_read_timeout"> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
592 <syntax><value>время</value></syntax> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
593 <default>60s</default> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
594 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
595 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
596 <context>location</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
597 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
598 <para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
599 Задаёт таймаут при чтении ответа проксированного сервера. |
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 а только между двумя операциями чтения. |
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 то nginx закрывает соединение. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
604 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
605 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
606 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
607 |
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 name="proxy_redirect"> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
610 <syntax><literal>default</literal></syntax> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
611 <syntax><literal>off</literal></syntax> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
612 <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
|
613 <default>default</default> |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
614 <context>http</context> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
615 <context>server</context> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
616 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
617 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
618 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
619 Задаёт текст, который нужно изменить в полях заголовка |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
620 <header>Location</header> и <header>Refresh</header> в ответе |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
621 проксируемого сервера. |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
622 Предположим, проксируемый сервер вернул поле заголовка |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
623 “<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
|
624 Директива |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
625 <example> |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
626 proxy_redirect http://localhost:8000/two/ http://frontend/one/; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
627 </example> |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
628 перепишет эту строку в виде |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
629 “<literal>Location: http://frontend/one/some/uri/</literal>”. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
630 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
631 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
632 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
633 В заменяемой строке можно не указывать имя сервера: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
634 <example> |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
635 proxy_redirect http://localhost:8000/two/ /; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
636 </example> |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
637 тогда будет подставлено основное имя сервера и порт, если он отличен от 80. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
638 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
639 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
640 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
641 Изменение по умолчанию, задаваемое значением <literal>default</literal>, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
642 использует параметры директив |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
643 <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
|
644 <link id="proxy_pass"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
645 Поэтому две нижеприведённые конфигурации одинаковы: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
646 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
647 location /one/ { |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
648 proxy_pass http://upstream:port/two/; |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
649 proxy_redirect default; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
650 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
651 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
652 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
653 location /one/ { |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
654 proxy_pass http://upstream:port/two/; |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
655 proxy_redirect http://upstream:port/two/ /one/; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
656 </example> |
271 | 657 Значение <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
|
658 используются переменные. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
659 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
660 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
661 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
662 В заменяемой строке можно использовать переменные: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
663 <example> |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
664 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
|
665 </example> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
666 </para> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
667 |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
668 <para> |
256
c78b2d6fe261
Use another term for "redirect".
Ruslan Ermilov <ru@nginx.com>
parents:
238
diff
changeset
|
669 В перенаправлении тоже можно использовать (1.1.11) переменные: |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
670 <example> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
671 proxy_redirect http://$proxy_host:8000/ /; |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
672 </example> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
673 </para> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
674 |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
675 <para> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
676 Директиву также можно задать (1.1.11) при помощи регулярных выражений. |
271 | 677 При этом <value>перенаправление</value> должно начинаться либо с символа |
678 “<literal>~</literal>”, если при сравнении следует учитывать регистр символов, | |
679 либо с символов “<literal>~*</literal>”, если регистр символов учитывать | |
680 не нужно. | |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
681 Регулярное выражение может содержать именованные и позиционные выделения, |
271 | 682 а <value>замена</value> ссылаться на них: |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
683 <example> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
684 proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2; |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
685 proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
686 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
687 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
688 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
689 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
690 Директив может быть несколько: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
691 <example> |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
692 proxy_redirect default; |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
693 proxy_redirect http://localhost:8000/ /; |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
694 proxy_redirect http://www.example.com/ /; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
695 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
696 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
697 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
698 <para> |
271 | 699 Значение <literal>off</literal> запрещает все директивы |
700 <literal>proxy_redirect</literal> | |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
701 на данном уровне: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
702 <example> |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
703 proxy_redirect off; |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
704 proxy_redirect default; |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
705 proxy_redirect http://localhost:8000/ /; |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
706 proxy_redirect http://www.example.com/ /; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
707 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
708 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
709 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
710 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
711 С помощью этой директивы можно также добавлять имя хоста к относительным |
256
c78b2d6fe261
Use another term for "redirect".
Ruslan Ermilov <ru@nginx.com>
parents:
238
diff
changeset
|
712 перенаправлениям, выдаваемым проксируемым сервером: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
713 <example> |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
714 proxy_redirect / /; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
715 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
716 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
717 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
718 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
719 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
720 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
721 <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
|
722 <syntax><value>время</value></syntax> |
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
723 <default>60</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
724 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
725 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
726 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
727 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
728 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
729 Задаёт таймаут при передаче запроса проксированному серверу. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
730 Таймаут устанавливается не на всю передачу запроса, |
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 Если по истечении этого времени проксируемый сервер не примет новых данных, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
733 то nginx закрывает соединение. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
734 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
737 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
738 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
739 <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
|
740 <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
|
741 <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
|
742 <default>Connection close</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
743 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
744 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
745 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
746 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
747 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
748 Позволяет переопределять или добавлять поля заголовка запроса, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
749 передаваемые проксируемому серверу. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
750 В качестве значения можно использовать текст, переменные и их комбинации. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
751 Директивы наследуются с предыдущего уровня при условии, что на данном |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
752 уровне не описаны свои директивы <literal>proxy_set_header</literal>. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
753 По умолчанию переопределяются только два поля: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
754 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
755 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
|
756 proxy_set_header Connection close; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
757 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
758 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
759 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
760 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
761 Неизменённое поле заголовка запроса <header>Host</header> можно передать так: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
762 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
763 proxy_set_header Host $http_host; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
764 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
765 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
766 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
767 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
768 Однако, если это поле отсутствует в заголовке запроса клиента, то ничего |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
769 передаваться не будет. В этом случае лучше воспользоваться переменной |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
770 <var>$host</var> - её значение равно имени сервера в поле <header>Host</header> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
771 заголовка запроса, или же основному имени сервера, если поля нет: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
772 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
773 proxy_set_header Host $host; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
774 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
775 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
776 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
777 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
778 Кроме того, можно передать имя сервера вместе с портом проксируемого сервера: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
779 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
780 proxy_set_header Host $host:$proxy_port; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
781 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
782 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
783 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
784 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
785 Если значение поля заголовка — пустая строка, то поле вообще |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
786 не будет передаваться проксируемому серверу: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
787 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
788 proxy_set_header Accept-Encoding ""; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
789 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
790 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
791 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
792 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
793 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
794 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
795 <directive name="proxy_ssl_session_reuse"> |
271 | 796 <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
|
797 <default>on</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
798 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
799 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
800 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
801 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
802 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
803 Определяет, использовать ли повторно SSL-сессии при |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
804 работе с проксированным сервером. Если в логах появляются ошибки |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
805 “<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
|
806 то можно попробовать выключить |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
807 повторное использование сессий. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
808 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
809 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
810 </directive> |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
813 <directive name="proxy_store"> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
814 <syntax> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
815 <literal>on</literal> | |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
816 <literal>off</literal> | |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
817 <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
|
818 <default>off</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
819 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
820 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
821 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
822 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
823 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
824 Разрешает сохранение на диск файлов. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
825 Параметр <literal>on</literal> сохраняет файлы в соответствии с путями, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
826 указанными в директивах |
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
827 <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
|
828 <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
|
829 Параметр <literal>off</literal> запрещает сохранение файлов. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
830 Кроме того, имя файла можно задать явно с помощью строки с переменными: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
831 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
832 proxy_store /data/www$original_uri; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
833 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
834 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
835 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
836 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
837 Время изменения файлов выставляется согласно полученному полю |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
838 <header>Last-Modified</header> в заголовке ответа. |
76
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 Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
841 могут располагаться на разных файловых системах, но нужно учитывать, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
842 что в этом случае вместо дешёвой операции переименовывания в пределах |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
843 одной файловой системы файл копируется с одной файловой системы на другую. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
844 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
845 системе, что и каталог с временными файлами, задаваемый директивой |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
846 <link id="proxy_temp_path"/> для данного location. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
847 </para> |
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 <para> |
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 неизменяемых файлов, например, так: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
852 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
853 location /images/ { |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
854 root /data/www; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
855 open_file_cache_errors off; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
856 error_page 404 = /fetch$uri; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
857 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
858 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
859 location /fetch/ { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
860 internal; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
861 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
862 proxy_pass http://backend/; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
863 proxy_store on; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
864 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
|
865 proxy_temp_path /data/temp; |
76
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 alias /data/www/; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
868 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
869 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
870 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
871 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
872 <para> |
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 location /images/ { |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
876 root /data/www; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
877 error_page 404 = @fetch; |
76
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
880 location @fetch { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
881 internal; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
882 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
883 proxy_pass http://backend; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
884 proxy_store on; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
885 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
|
886 proxy_temp_path /data/temp; |
76
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 root /data/www; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
889 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
890 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
891 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
892 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
893 </directive> |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
896 <directive name="proxy_store_access"> |
271 | 897 <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
|
898 <default>user:rw</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
899 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
900 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
901 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
902 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
903 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
904 Задаёт права доступа для создаваемых файлов и каталогов, например, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
905 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
906 proxy_store_access user:rw group:rw all:r; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
907 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
908 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
909 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
910 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
911 Если заданы какие-либо права для <literal>group</literal> или |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
912 <literal>all</literal>, то права для <literal>user</literal> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
913 указывать необязательно: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
914 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
915 proxy_store_access group:rw all:r; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
916 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
917 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
920 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
921 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
922 <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
|
923 <syntax> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
924 <value>путь</value> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
925 [<value>уровень1</value> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
926 [<value>уровень2</value> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
927 [<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
|
928 <default>proxy_temp</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
929 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
930 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
931 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
932 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
933 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
934 Задаёт имя каталога для хранения временных файлов, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
935 полученных от другого сервера. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
936 В каталоге может использоваться иерархия подкаталогов до трёх уровней. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
937 Например, при такой конфигурации |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
938 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
939 proxy_temp_path /spool/nginx/proxy_temp 1 2; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
940 </example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
941 временный файл будет следующего вида: |
98 | 942 <example> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
943 /spool/nginx/proxy_temp/7/45/00000123457 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
944 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
945 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
946 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
947 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
948 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
949 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
950 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
951 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
952 <section id="variables" name="Встроенные переменные"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
953 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
954 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
955 В модуле <literal>ngx_http_proxy_module</literal> есть встроенные переменные, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
956 которые можно использовать для формирования заголовков с помощью директивы |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
957 <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
|
958 <list type="tag"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
959 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
960 <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
|
961 <tag-desc>имя проксируемого хоста и порт;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
962 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
963 <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
|
964 <tag-desc>порт проксируемого хоста;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
965 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
966 <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
|
967 <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
|
968 и добавленная к нему через запятую переменная <var>$remote_addr</var>. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
969 Если же поля <header>X-Forwarded-For</header> в заголовке запроса клиента нет, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
970 то переменная <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
|
971 равна переменной <var>$remote_addr</var>.</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
972 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
973 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
974 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
975 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
976 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
977 </module> |