Mercurial > hg > nginx-site
annotate xml/ru/docs/http/ngx_http_proxy_module.xml @ 795:41363f013cc9
Documented the recently added "gzip" and "flush" parameters of the "access_log"
directive.
author | Valentin Bartenev <vbart@nginx.com> |
---|---|
date | Tue, 25 Dec 2012 15:23:24 +0000 |
parents | 15f2bab0740d |
children | 9e5847af3b2d |
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 |
580
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
575
diff
changeset
|
3 <!-- |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
575
diff
changeset
|
4 Copyright (C) Igor Sysoev |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
575
diff
changeset
|
5 Copyright (C) Nginx, Inc. |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
575
diff
changeset
|
6 --> |
be54c443235a
Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents:
575
diff
changeset
|
7 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
9 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
10 <module name="Модуль ngx_http_proxy_module" |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
11 link="/ru/docs/http/ngx_http_proxy_module.html" |
589 | 12 lang="ru" |
790
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
13 rev="6"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
14 |
110
40eec261c2a6
Added proper support for anonymous sections, notably for the summary.
Ruslan Ermilov <ru@nginx.com>
parents:
106
diff
changeset
|
15 <section id="summary"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
16 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
17 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
18 Модуль <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
|
19 запросы другому серверу. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
20 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
21 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
22 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
23 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
24 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
25 <section id="example" name="Пример конфигурации"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
26 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
27 <para> |
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 location / { |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
30 proxy_pass http://localhost:8000; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
31 proxy_set_header Host $host; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
32 proxy_set_header X-Real-IP $remote_addr; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
33 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
34 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
35 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
36 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
37 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
38 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
39 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
40 <section id="directives" name="Директивы"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
41 |
772
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
42 <directive name="proxy_bind"> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
43 <syntax><value>адрес</value></syntax> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
44 <default/> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
45 <context>http</context> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
46 <context>server</context> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
47 <context>location</context> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
48 <appeared-in>0.8.22</appeared-in> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
49 |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
50 <para> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
51 Задаёт локальный IP-<value>адрес</value>, который будет использоваться в |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
52 исходящих соединениях с проксируемым сервером. |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
53 </para> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
54 |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
55 </directive> |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
56 |
ce121bf644f5
Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
625
diff
changeset
|
57 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
58 <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
|
59 <syntax><value>размер</value></syntax> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
60 <default>4k|8k</default> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
61 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
62 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
63 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
64 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
65 <para> |
279 | 66 Задаёт <value>размер</value> буфера, в который будет читаться |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
67 первая часть ответа, получаемого от проксируемого сервера. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
68 В этой части ответа находится, как правило, небольшой заголовок ответа. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
69 По умолчанию размер буфера равен размеру одного буфера в директиве |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
70 <link id="proxy_buffers"/>, однако его можно сделать меньше. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
71 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
72 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
73 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
74 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
75 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
76 <directive name="proxy_buffering"> |
271 | 77 <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
|
78 <default>on</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
79 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
80 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
81 <context>location</context> |
76
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 <para> |
405
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
84 Разрешает или запрещает использовать буферизацию ответов проксируемого сервера. |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
85 </para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
86 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
87 <para> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
88 Если буферизация включена, то nginx принимает ответ проксируемого сервера |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
89 как можно быстрее, сохраняя его в буферы, заданные директивами |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
90 <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>. |
405
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
91 Если ответ не вмещается целиком в память, то его часть может быть записана |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
92 на диск во <link id="proxy_temp_path">временный файл</link>. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
93 Запись во временные файлы контролируется директивами |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
94 <link id="proxy_max_temp_file_size"/> и |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
95 <link id="proxy_temp_file_write_size"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
96 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
97 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
98 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
99 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
100 по мере его поступления. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
101 nginx не пытается считать весь ответ проксируемого сервера. |
279 | 102 Максимальный размер данных, который nginx может принять от сервера |
103 за один раз, задаётся директивой <link id="proxy_buffer_size"/>. | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
104 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
105 |
506
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
106 <para> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
107 Буферизация может быть также включена или выключена путём передачи |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
108 значения “<literal>yes</literal>” или “<literal>no</literal>” в поле |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
109 <header>X-Accel-Buffering</header> заголовка ответа. |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
110 Эту возможность можно запретить с помощью директивы |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
111 <link doc="ngx_http_proxy_module.xml" id="proxy_ignore_headers"/>. |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
112 </para> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
113 |
76
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_buffers"> |
271 | 118 <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
|
119 <default>8 4k|8k</default> |
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> |
279 | 125 Задаёт <value>число</value> и <value>размер</value> буферов |
126 для одного соединения, | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
127 в которые будет читаться ответ, получаемый от проксируемого сервера. |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
128 По умолчанию размер одного буфера равен размеру страницы. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
129 В зависимости от платформы это или 4K, или 8K. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
130 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
131 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
132 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
133 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
134 |
405
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
135 <directive name="proxy_busy_buffers_size"> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
136 <syntax><value>размер</value></syntax> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
137 <default>8k|16k</default> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
138 <context>http</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
139 <context>server</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
140 <context>location</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
141 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
142 <para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
143 При включённой <link id="proxy_buffering">буферизации</link> ответов |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
144 проксируемого сервера, ограничивает суммарный <value>размер</value> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
145 буферов, которые могут быть заняты для отправки ответа клиенту, пока |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
146 ответ ещё не прочитан целиком. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
147 Оставшиеся буферы тем временем могут использоваться для чтения ответа |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
148 и, при необходимости, буферизации части ответа во временный файл. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
149 По умолчанию <value>размер</value> ограничен двумя буферами, заданными |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
150 директивами <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
151 </para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
152 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
153 </directive> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
154 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
155 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
156 <directive name="proxy_cache"> |
271 | 157 <syntax><value>зона</value> | <literal>off</literal></syntax> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
158 <default>off</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
159 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
160 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
161 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
162 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
163 <para> |
575
ebcb351d9eb3
Consistently using the term "shared memory zone".
Ruslan Ermilov <ru@nginx.com>
parents:
535
diff
changeset
|
164 Задаёт зону разделяемой памяти, используемой для кэширования. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
165 Одна и та же зона может использоваться в нескольких местах. |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
166 Параметр <literal>off</literal> запрещает кэширование, унаследованное |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
167 с предыдущего уровня конфигурации. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
168 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
169 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
170 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
171 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
172 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
173 <directive name="proxy_cache_bypass"> |
271 | 174 <syntax><value>строка</value> ...</syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
175 <default/> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
176 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
177 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
178 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
179 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
180 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
181 Задаёт условия, при которых ответ не будет браться из кэша. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
182 Если значение хотя бы одного из строковых параметров непустое и не равно “0”, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
183 то ответ не берётся из кэша: |
98 | 184 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
185 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
|
186 proxy_cache_bypass $http_pragma $http_authorization; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
187 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
188 Можно использовать совместно с директивой <link id="proxy_no_cache"/>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
189 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
190 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
191 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
192 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
193 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
194 <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
|
195 <syntax><value>строка</value></syntax> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
196 <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
|
197 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
198 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
199 <context>location</context> |
76
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 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
202 Задаёт ключ для кэширования, например, |
98 | 203 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
204 proxy_cache_key "$host$request_uri $cookie_user"; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
205 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
206 По умолчанию значение директивы близко к строке |
98 | 207 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
208 proxy_cache_key $scheme$proxy_host$uri$is_args$args; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
209 </example> |
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 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
212 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
213 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
214 |
302
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
215 <directive name="proxy_cache_lock"> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
216 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
217 <default>off</default> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
218 <context>http</context> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
219 <context>server</context> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
220 <context>location</context> |
310
86732337c730
Added a historical information for proxy_cache_lock, proxy_cache_lock_timeout,
Ruslan Ermilov <ru@nginx.com>
parents:
302
diff
changeset
|
221 <appeared-in>1.1.12</appeared-in> |
302
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
222 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
223 <para> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
224 Если включено, одновременно только одному запросу будет позволено |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
225 заполнить новый элемент кэша, идентифицируемый согласно директиве |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
226 <link id="proxy_cache_key"/>, передав запрос на проксируемый сервер. |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
227 Остальные запросы этого же элемента будут либо ожидать |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
228 появления ответа в кэше, либо освобождения блокировки |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
229 этого элемента, в течение времени, заданного директивой |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
230 <link id="proxy_cache_lock_timeout"/>. |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
231 </para> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
232 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
233 </directive> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
234 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
235 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
236 <directive name="proxy_cache_lock_timeout"> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
237 <syntax><value>время</value></syntax> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
238 <default>5s</default> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
239 <context>http</context> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
240 <context>server</context> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
241 <context>location</context> |
310
86732337c730
Added a historical information for proxy_cache_lock, proxy_cache_lock_timeout,
Ruslan Ermilov <ru@nginx.com>
parents:
302
diff
changeset
|
242 <appeared-in>1.1.12</appeared-in> |
302
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
243 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
244 <para> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
245 Задаёт таймаут для <link id="proxy_cache_lock"/>. |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
246 </para> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
247 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
248 </directive> |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
249 |
df728215db07
Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents:
296
diff
changeset
|
250 |
790
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
251 <directive name="proxy_cache_methods"> |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
252 <syntax> |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
253 <literal>GET</literal> | |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
254 <literal>HEAD</literal> | |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
255 <literal>POST</literal> |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
256 ...</syntax> |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
257 <default>GET HEAD</default> |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
258 <context>http</context> |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
259 <context>server</context> |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
260 <context>location</context> |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
261 <appeared-in>0.7.59</appeared-in> |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
262 |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
263 <para> |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
264 Если метод запроса клиента указан в этой директиве, |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
265 то ответ будет закэширован. |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
266 Методы “<literal>GET</literal>” и “<literal>HEAD</literal>” всегда добавляются |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
267 в список, но тем не менее рекомендуется перечислять их явно. |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
268 См. также директиву <link id="proxy_no_cache"/>. |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
269 </para> |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
270 |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
271 </directive> |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
272 |
ae776a353984
Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents:
789
diff
changeset
|
273 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
274 <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
|
275 <syntax><value>число</value></syntax> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
276 <default>1</default> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
277 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
278 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
279 <context>location</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
280 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
281 <para> |
279 | 282 Задаёт <value>число</value> запросов, после которого ответ будет закэширован. |
273
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 </directive> |
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 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
288 <directive name="proxy_cache_path"> |
271 | 289 <syntax> |
364 | 290 <value>путь</value> |
291 [<literal>levels</literal>=<value>уровни</value>] | |
292 <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value> | |
293 [<literal>inactive</literal>=<value>время</value>] | |
508
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
294 [<literal>max_size</literal>=<value>размер</value>] |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
295 [<literal>loader_files</literal>=<value>число</value>] |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
296 [<literal>loader_sleep</literal>=<value>время</value>] |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
297 [<literal>loader_threshold</literal>=<value>время</value>]</syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
298 <default/> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
299 <context>http</context> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
300 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
301 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
302 Задаёт путь и другие параметры кэша. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
303 Данные кэша хранятся в файлах. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
304 Ключом и именем файла в кэше является результат функции MD5 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
305 от проксированного URL. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
306 Параметр <literal>levels</literal> задаёт уровни иерархии кэша, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
307 например, при использовании |
98 | 308 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
309 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
|
310 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
311 имена файлов в кэше будут такого вида: |
98 | 312 <example> |
279 | 313 /data/nginx/cache/<emphasis>c</emphasis>/<emphasis>29</emphasis>/b7f54b2df7773722d382f4809d650<emphasis>29c</emphasis> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
314 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
315 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
316 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
317 <para> |
279 | 318 Кэшируемый ответ сначала записывается во временный файл, а потом этот файл |
364 | 319 переименовывается. |
320 Начиная с версии 0.8.9, временные файлы и кэш | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
321 могут располагаться на разных файловых системах, но нужно учитывать, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
322 что в этом случае вместо дешёвой операции переименовывания в пределах |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
323 одной файловой системы файл копируется с одной файловой системы на другую. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
324 Поэтому лучше, если кэш будет находиться на той же файловой |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
325 системе, что и каталог с временными файлами, задаваемый директивой |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
326 <link id="proxy_temp_path"/> для данного location. |
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 <para> |
575
ebcb351d9eb3
Consistently using the term "shared memory zone".
Ruslan Ermilov <ru@nginx.com>
parents:
535
diff
changeset
|
330 Кроме того, все активные ключи и информация о данных хранятся в зоне |
ebcb351d9eb3
Consistently using the term "shared memory zone".
Ruslan Ermilov <ru@nginx.com>
parents:
535
diff
changeset
|
331 разделяемой памяти, <value>имя</value> и <value>размер</value> которой |
279 | 332 задаются параметром <literal>keys_zone</literal>. |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
333 Если к данным кэша не обращаются в течение времени, заданного параметром |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
334 <literal>inactive</literal>, то данные удаляются, независимо от их свежести. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
335 По умолчанию <literal>inactive</literal> равен 10 минутам. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
336 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
337 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
338 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
339 Специальный процесс “cache manager” следит за максимальным размером кэша, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
340 заданным параметром <literal>max_size</literal>, и при превышении |
507 | 341 его размеров удаляет наименее востребованные данные. |
76
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 |
508
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
344 <para> |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
345 Через минуту после старта активируется специальный процесс “cache loader”, |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
346 который загружает в зону кэша информацию о ранее закэшированных данных, |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
347 хранящихся на файловой системе. |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
348 Загрузка происходит итерациями. |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
349 За одну итерацию загружается не более <literal>loader_files</literal> |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
350 элементов (по умолчанию 100). |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
351 Кроме того, время работы одной итерации ограничено параметром |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
352 <literal>loader_threshold</literal> (по умолчанию 200 миллисекунд). |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
353 Между итерациями делается пауза на время, заданное параметром |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
354 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд). |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
355 </para> |
5e332fafd228
Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents:
507
diff
changeset
|
356 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
357 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
358 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
359 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
360 <directive name="proxy_cache_use_stale"> |
271 | 361 <syntax> |
364 | 362 <literal>error</literal> | |
363 <literal>timeout</literal> | | |
364 <literal>invalid_header</literal> | | |
365 <literal>updating</literal> | | |
366 <literal>http_500</literal> | | |
367 <literal>http_502</literal> | | |
368 <literal>http_503</literal> | | |
369 <literal>http_504</literal> | | |
370 <literal>http_404</literal> | | |
371 <literal>off</literal> | |
372 ...</syntax> | |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
373 <default>off</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
374 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
375 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
376 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
377 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
378 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
379 Определяет, в каких случаях можно использовать |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
380 устаревший закэшированный ответ, если при работе с проксированным |
364 | 381 сервером возникла ошибка. |
382 Параметры директивы совпадают с параметрами | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
383 директивы <link id="proxy_next_upstream"/>. |
504
695f83494c19
Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
417
diff
changeset
|
384 </para> |
695f83494c19
Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
417
diff
changeset
|
385 |
695f83494c19
Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
417
diff
changeset
|
386 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
387 Кроме того, дополнительный параметр <literal>updating</literal> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
388 разрешает использовать устаревший закэшированный ответ, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
389 если на данный момент он уже обновляется. |
504
695f83494c19
Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
417
diff
changeset
|
390 Это позволяет минимизировать число обращений к проксированным серверам |
695f83494c19
Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
417
diff
changeset
|
391 при обновлении закэшированных данных. |
695f83494c19
Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
417
diff
changeset
|
392 </para> |
695f83494c19
Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
417
diff
changeset
|
393 |
695f83494c19
Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
417
diff
changeset
|
394 <para> |
695f83494c19
Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
417
diff
changeset
|
395 Чтобы минимизировать число обращений к проксированным серверам при |
695f83494c19
Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
417
diff
changeset
|
396 заполнении нового элемента кэша, можно воспользоваться директивой |
695f83494c19
Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents:
417
diff
changeset
|
397 <link id="proxy_cache_lock"/>. |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
398 </para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
399 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
400 </directive> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
401 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
402 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
403 <directive name="proxy_cache_valid"> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
404 <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
|
405 <default/> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
406 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
407 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
408 <context>location</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
409 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
410 <para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
411 Задаёт время кэширования для разных кодов ответа. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
412 Например, директивы |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
413 <example> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
414 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
|
415 proxy_cache_valid 404 1m; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
416 </example> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
417 задают время кэширования 10 минут для ответов с кодами 200 и 302, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
418 и 1 минуту для ответов с кодом 404. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
419 </para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
420 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
421 <para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
422 Если указано только <value>время</value> кэширования, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
423 <example> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
424 proxy_cache_valid 5m; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
425 </example> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
426 то кэшируются только ответы 200, 301 и 302. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
427 </para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
428 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
429 <para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
430 Кроме того, можно кэшировать любые ответы с помощью параметра |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
431 <literal>any</literal>: |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
432 <example> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
433 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
|
434 proxy_cache_valid 301 1h; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
435 proxy_cache_valid any 1m; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
436 </example> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
437 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
438 |
506
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
439 <para> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
440 Параметры кэширования могут также быть заданы непосредственно |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
441 в заголовке ответа. |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
442 Такой способ приоритетнее, чем задание времени кэширования с помощью директивы. |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
443 Поле заголовка <header>X-Accel-Expires</header> задаёт время кэширования |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
444 ответа в секундах. |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
445 Значение 0 запрещает кэшировать ответ. |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
446 Если значение начинается с префикса <literal>@</literal>, оно задаёт абсолютное |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
447 время в секундах с начала эпохи, до которого ответ может быть закэширован. |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
448 Если в заголовке нет поля <header>X-Accel-Expires</header>, |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
449 параметры кэширования определяются по полям заголовка |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
450 <header>Expires</header> или <header>Cache-Control</header>. |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
451 Ответ, в заголовке которого есть поле <header>Set-Cookie</header>, |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
452 не будет кэшироваться. |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
453 Обработка одного или более из этих полей заголовка может быть отключена |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
454 при помощи директивы <link id="proxy_ignore_headers"/>. |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
455 </para> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
456 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
457 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
458 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
459 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
460 <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
|
461 <syntax><value>время</value></syntax> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
462 <default>60s</default> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
463 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
464 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
465 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
466 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
467 <para> |
279 | 468 Задаёт таймаут для установления соединения с проксированным сервером. |
469 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд. | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
470 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
471 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
472 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
473 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
474 |
417
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
475 <directive name="proxy_cookie_domain"> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
476 <syntax><literal>off</literal></syntax> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
477 <syntax><value>домен</value> <value>замена</value></syntax> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
478 <default>off</default> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
479 <context>http</context> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
480 <context>server</context> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
481 <context>location</context> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
482 <appeared-in>1.1.15</appeared-in> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
483 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
484 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
485 Задаёт текст, который нужно изменить в атрибуте <literal>domain</literal> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
486 полей <header>Set-Cookie</header> заголовка ответа проксируемого сервера. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
487 Предположим, проксируемый сервер вернул поле заголовка |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
488 <header>Set-Cookie</header> с атрибутом |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
489 “<literal>domain=localhost</literal>”. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
490 Директива |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
491 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
492 proxy_cookie_domain localhost example.org; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
493 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
494 перепишет данный атрибут в виде |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
495 “<literal>domain=example.org</literal>”. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
496 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
497 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
498 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
499 Точка в начале строк <value>домен</value> и <value>замена</value>, |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
500 а равно как и в атрибуте <literal>domain</literal> игнорируется. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
501 Регистр значения не имеет. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
502 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
503 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
504 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
505 В строках <value>домен</value> и <value>замена</value> можно использовать |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
506 переменные: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
507 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
508 proxy_cookie_domain www.$host $host; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
509 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
510 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
511 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
512 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
513 Директиву также можно задать при помощи регулярных выражений. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
514 При этом <value>домен</value> должен начинаться с символа |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
515 “<literal>~</literal>”. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
516 Регулярное выражение может содержать именованные и позиционные выделения, |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
517 а <value>замена</value> ссылаться на них: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
518 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
519 proxy_cookie_domain ~\.(?P<sl_domain>[-0-9a-z]+\.[a-z]+)$ $sl_domain; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
520 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
521 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
522 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
523 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
524 Директив <literal>proxy_cookie_domain</literal> может быть несколько: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
525 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
526 proxy_cookie_domain localhost example.org; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
527 proxy_cookie_domain ~\.([a-z]+\.[a-z]+)$ $1; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
528 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
529 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
530 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
531 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
532 Параметр <literal>off</literal> запрещает все директивы |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
533 <literal>proxy_cookie_domain</literal> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
534 на данном уровне: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
535 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
536 proxy_cookie_domain off; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
537 proxy_cookie_domain localhost example.org; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
538 proxy_cookie_domain www.example.org example.org; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
539 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
540 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
541 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
542 </directive> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
543 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
544 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
545 <directive name="proxy_cookie_path"> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
546 <syntax><literal>off</literal></syntax> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
547 <syntax><value>путь</value> <value>замена</value></syntax> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
548 <default>off</default> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
549 <context>http</context> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
550 <context>server</context> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
551 <context>location</context> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
552 <appeared-in>1.1.15</appeared-in> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
553 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
554 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
555 Задаёт текст, который нужно изменить в атрибуте <literal>path</literal> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
556 полей <header>Set-Cookie</header> заголовка ответа проксируемого сервера. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
557 Предположим, проксируемый сервер вернул поле заголовка |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
558 <header>Set-Cookie</header> с атрибутом |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
559 “<literal>path=/two/some/uri/</literal>”. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
560 Директива |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
561 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
562 proxy_cookie_path /two/ /; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
563 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
564 перепишет данный атрибут в виде |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
565 “<literal>path=/some/uri/</literal>”. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
566 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
567 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
568 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
569 В строках <value>путь</value> и <value>замена</value> можно использовать |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
570 переменные: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
571 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
572 proxy_cookie_path $uri /some$uri; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
573 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
574 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
575 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
576 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
577 Директиву также можно задать при помощи регулярных выражений. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
578 При этом <value>путь</value> должен начинаться либо с символа |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
579 “<literal>~</literal>”, если при сравнении следует учитывать регистр символов, |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
580 либо с символов “<literal>~*</literal>”, если регистр символов учитывать |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
581 не нужно. |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
582 Регулярное выражение может содержать именованные и позиционные выделения, |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
583 а <value>замена</value> ссылаться на них: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
584 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
585 proxy_cookie_path ~*^/user/([^/]+) /u/$1; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
586 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
587 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
588 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
589 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
590 Директив <literal>proxy_cookie_path</literal> может быть несколько: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
591 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
592 proxy_cookie_path /one/ /; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
593 proxy_cookie_path / /two/; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
594 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
595 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
596 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
597 <para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
598 Параметр <literal>off</literal> запрещает все директивы |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
599 <literal>proxy_cookie_path</literal> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
600 на данном уровне: |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
601 <example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
602 proxy_cookie_path off; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
603 proxy_cookie_path /two/ /; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
604 proxy_cookie_path ~*^/user/([^/]+) /u/$1; |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
605 </example> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
606 </para> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
607 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
608 </directive> |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
609 |
cbc2d1b51cb6
Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents:
405
diff
changeset
|
610 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
611 <directive name="proxy_hide_header"> |
279 | 612 <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
|
613 <default/> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
614 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
615 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
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> |
279 | 619 По умолчанию |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
620 nginx не передаёт клиенту поля заголовка <header>Date</header>, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
621 <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
|
622 <header>X-Accel-...</header> из ответа проксированного сервера. |
279 | 623 Директива <literal>proxy_hide_header</literal> задаёт дополнительные поля, |
624 которые не будут передаваться. | |
291 | 625 Если же передачу полей нужно разрешить, можно воспользоваться |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
626 директивой <link id="proxy_pass_header"/>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
627 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
628 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
629 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
630 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
631 |
316
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
632 <directive name="proxy_http_version"> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
633 <syntax><literal>1.0</literal> | <literal>1.1</literal></syntax> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
634 <default>1.0</default> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
635 <context>http</context> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
636 <context>server</context> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
637 <context>location</context> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
638 <appeared-in>1.1.4</appeared-in> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
639 |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
640 <para> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
641 Задаёт версию протокола HTTP для проксирования. |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
642 По умолчанию используется версия 1.0. |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
643 Для работы |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
644 <link doc="ngx_http_upstream_module.xml" id="keepalive">постоянных |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
645 соединений</link> рекомендуется версия 1.1. |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
646 </para> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
647 |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
648 </directive> |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
649 |
1fb1c077658b
Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents:
310
diff
changeset
|
650 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
651 <directive name="proxy_ignore_client_abort"> |
271 | 652 <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
|
653 <default>off</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
654 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
655 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
656 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
657 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
658 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
659 Определяет, закрывать ли соединение с проксированным сервером |
76
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
664 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
665 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
666 <directive name="proxy_ignore_headers"> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
667 <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
|
668 <default/> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
669 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
670 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
671 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
672 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
673 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
674 Запрещает обработку некоторых полей заголовка из ответа проксированного сервера. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
675 В директиве можно указать поля <header>X-Accel-Redirect</header>, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
676 <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
|
677 <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
|
678 <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
|
679 <header>Cache-Control</header> и <header>Set-Cookie</header> (0.8.44). |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
680 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
681 |
506
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
682 <para> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
683 Если не запрещено, обработка этих полей заголовка заключается в следующем: |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
684 <list type="bullet" compact="no"> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
685 |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
686 <listitem> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
687 <header>X-Accel-Expires</header>, <header>Expires</header>, |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
688 <header>Cache-Control</header> и <header>Set-Cookie</header> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
689 задают параметры <link id="proxy_cache_valid">кэширования</link> ответа; |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
690 </listitem> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
691 |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
692 <listitem> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
693 <header>X-Accel-Redirect</header> производит |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
694 <link doc="ngx_http_core_module.xml" id="internal">внутреннее |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
695 перенаправление</link> на указанный URI; |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
696 </listitem> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
697 |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
698 <listitem> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
699 <header>X-Accel-Limit-Rate</header> задаёт |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
700 <link doc="ngx_http_core_module.xml" id="limit_rate">ограничение |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
701 скорости</link> передачи ответа клиенту; |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
702 </listitem> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
703 |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
704 <listitem> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
705 <header>X-Accel-Buffering</header> включает или выключает |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
706 <link id="proxy_buffering">буферизацию</link> ответа; |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
707 </listitem> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
708 |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
709 <listitem> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
710 <header>X-Accel-Charset</header> задаёт желаемую |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
711 <link doc="ngx_http_charset_module.xml" id="charset">кодировку</link> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
712 ответа. |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
713 </listitem> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
714 |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
715 </list> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
716 </para> |
657848837328
Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents:
504
diff
changeset
|
717 |
76
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_intercept_errors"> |
271 | 722 <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
|
723 <default>off</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 Определяет, передавать ли клиенту проксированные ответы с кодом |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
730 больше либо равным 400, или же перенаправлять их на обработку nginx’у с помощью |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
731 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
732 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
733 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
734 </directive> |
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 |
405
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
737 <directive name="proxy_max_temp_file_size"> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
738 <syntax><value>размер</value></syntax> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
739 <default>1024m</default> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
740 <context>http</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
741 <context>server</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
742 <context>location</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
743 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
744 <para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
745 Если включена <link id="proxy_buffering">буферизация</link> ответов |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
746 проксируемого сервера, и ответ не вмещается целиком в буферы памяти, |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
747 заданные директивами <link id="proxy_buffer_size"/> и |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
748 <link id="proxy_buffers"/>, часть ответа может быть записана во временный файл. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
749 Эта директива задаёт максимальный <value>размер</value> временного файла. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
750 Размер данных, сбрасываемых во временный файл за один раз, задаётся |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
751 директивой <link id="proxy_temp_file_write_size"/>. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
752 </para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
753 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
754 <para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
755 Значение 0 отключает возможность буферизации ответов во временные файлы. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
756 </para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
757 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
758 </directive> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
759 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
760 |
787
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
761 <directive name="proxy_method"> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
762 <syntax><value>метод</value></syntax> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
763 <default/> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
764 <context>http</context> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
765 <context>server</context> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
766 <context>location</context> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
767 |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
768 <para> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
769 Задаёт HTTP-<value>метод</value>, который будет использоваться |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
770 в передаваемых на проксируемый сервер запросах вместо метода |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
771 из клиентского запроса. |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
772 </para> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
773 |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
774 </directive> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
775 |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
776 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
777 <directive name="proxy_next_upstream"> |
271 | 778 <syntax> |
364 | 779 <literal>error</literal> | |
780 <literal>timeout</literal> | | |
781 <literal>invalid_header</literal> | | |
782 <literal>http_500</literal> | | |
783 <literal>http_502</literal> | | |
784 <literal>http_503</literal> | | |
785 <literal>http_504</literal> | | |
786 <literal>http_404</literal> | | |
787 <literal>off</literal> | |
788 ...</syntax> | |
102
c76a257f3fd4
The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents:
99
diff
changeset
|
789 <default>error timeout</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
790 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
791 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
792 <context>location</context> |
76
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 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
795 Определяет, в каких случаях запрос будет передан следующему серверу: |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
796 <list type="tag"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
797 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
798 <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
|
799 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
800 чтения заголовка ответа сервера;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
801 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
802 <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
|
803 <tag-desc>произошёл таймаут во время соединения с сервером, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
804 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
805 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
806 <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
|
807 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
808 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
809 <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
|
810 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
811 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
812 <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
|
813 <tag-desc>сервер вернул ответ с кодом 502;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
814 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
815 <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
|
816 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
817 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
818 <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
|
819 <tag-desc>сервер вернул ответ с кодом 504;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
820 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
821 <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
|
822 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
823 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
824 <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
|
825 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
826 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
827 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
828 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
829 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
830 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
831 Необходимо понимать, что передача запроса следующему серверу возможна |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
832 только при условии, что клиенту ещё ничего не передавалось. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
833 То есть, если ошибка или таймаут возникли в середине передачи ответа, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
834 то исправить это уже невозможно. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
835 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
836 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
837 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
838 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
839 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
840 <directive name="proxy_no_cache"> |
271 | 841 <syntax><value>строка</value> ...</syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
842 <default/> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
843 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
844 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
845 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
846 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
847 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
848 Задаёт условия, при которых ответ не будет сохраняться в кэш. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
849 Если значение хотя бы одного из строковых параметров непустое и не равно “0”, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
850 то ответ не будет сохранён: |
98 | 851 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
852 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
|
853 proxy_no_cache $http_pragma $http_authorization; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
854 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
855 Можно использовать совместно с директивой <link id="proxy_cache_bypass"/>. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
856 </para> |
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 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
859 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
860 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
861 <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
|
862 <syntax><value>URL</value></syntax> |
99
1d315ef37215
The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents:
98
diff
changeset
|
863 <default/> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
864 <context>location</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
865 <context>if в location</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
866 <context>limit_except</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
867 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
868 <para> |
791
15f2bab0740d
Fixed a typo in the "proxy_pass" directive description.
Vladimir Homutov <vl@nginx.com>
parents:
790
diff
changeset
|
869 Задаёт протокол и адрес проксируемого сервера, а также необязательный URI, |
535
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
870 на который должен отображаться location. |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
871 В качестве протокола можно указать |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
872 “<literal>http</literal>” или “<literal>https</literal>”. |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
873 Адрес может быть указан в виде доменного имени или IP-адреса, |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
874 и необязательного порта: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
875 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
876 proxy_pass http://localhost:8000/uri/; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
877 </example> |
535
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
878 или в виде пути UNIX-сокета, который указывается после слова |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
879 “<literal>unix</literal>” и заключается в двоеточия: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
880 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
881 proxy_pass http://unix:/tmp/backend.socket:/uri/; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
882 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
883 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
884 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
885 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
886 Если доменному имени соответствует несколько адресов, то все они будут |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
887 использоваться по очереди (round-robin). |
535
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
888 Кроме того, в качестве адреса можно указать |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
889 <link doc="ngx_http_upstream_module.xml">группу серверов</link>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
890 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
891 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
892 <para> |
535
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
893 URI запроса передаётся на сервер так: |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
894 <list type="bullet" compact="no"> |
76
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 <listitem> |
535
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
897 Если <literal>proxy_pass</literal> указана с URI, |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
898 то при передаче запроса серверу часть |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
899 <link doc="ngx_http_core_module.xml" id="location">нормализованного</link> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
900 URI запроса, соответствующая location, заменяется на URI, |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
901 указанный в директиве: |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
902 <example> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
903 location /name/ { |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
904 proxy_pass http://127.0.0.1/remote/; |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
905 } |
535
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
906 </example> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
907 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
908 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
909 <listitem> |
535
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
910 Если <literal>proxy_pass</literal> указана без URI, |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
911 то при обработке первоначального запроса на сервер передаётся |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
912 URI запроса в том же виде, в каком его прислал клиент, |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
913 а при обработке изменённого URI— |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
914 нормализованный URI запроса целиком: |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
915 <example> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
916 location /some/path/ { |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
917 proxy_pass http://127.0.0.1; |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
918 } |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
919 </example> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
920 <note> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
921 До версии 1.1.12, |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
922 если <literal>proxy_pass</literal> указана без URI, |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
923 в ряде случаев при изменении URI на сервер мог передаваться |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
924 URI первоначального запроса вместо изменённого URI. |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
925 </note> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
926 </listitem> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
927 </list> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
928 </para> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
929 |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
930 <para> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
931 В ряде случаев часть URI запроса, подлежащую замене, выделить невозможно: |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
932 <list type="bullet" compact="no"> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
933 |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
934 <listitem> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
935 Если location задан регулярным выражением. |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
936 <para> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
937 В этом случае директиву следует указывать без URI. |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
938 </para> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
939 </listitem> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
940 |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
941 <listitem> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
942 Если внутри проксируемого location с помощью директивы |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
943 <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
|
944 URI, и именно с этой конфигурацией будет обрабатываться запрос |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
945 (<literal>break</literal>): |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
946 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
947 location /name/ { |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
948 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
|
949 proxy_pass http://127.0.0.1; |
76
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 </example> |
535
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
952 <para> |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
953 В этом случае URI, указанный в директиве, игнорируется, и на сервер |
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
954 передаётся изменённый URI запроса целиком. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
955 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
956 </listitem> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
957 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
958 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
959 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
960 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
961 Имя сервера, его порт и передаваемый URI можно также полностью задать |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
962 с помощью переменных: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
963 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
964 proxy_pass http://$host$uri; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
965 </example> |
535
f8652d663b62
Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents:
508
diff
changeset
|
966 или даже так: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
967 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
968 proxy_pass $request; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
969 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
970 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
971 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
972 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
973 В этом случае имя сервера ищется среди описанных |
135
edf8c90f8085
Renamed ngx_http_upstream to ngx_http_upstream_module.
Ruslan Ermilov <ru@nginx.com>
parents:
110
diff
changeset
|
974 <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
|
975 и если не найдено, то определяется с помощью |
625
af3f38e349eb
Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents:
589
diff
changeset
|
976 <link doc="ngx_http_core_module.xml" id="resolver"/>’а. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
977 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
978 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
979 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
980 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
981 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
982 <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
|
983 <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
|
984 <default/> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
985 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
986 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
987 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
988 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
989 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
990 Разрешает передавать от проксируемого сервера клиенту |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
991 <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
|
992 </para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
993 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
994 </directive> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
995 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
996 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
997 <directive name="proxy_read_timeout"> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
998 <syntax><value>время</value></syntax> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
999 <default>60s</default> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1000 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1001 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1002 <context>location</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1003 |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1004 <para> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1005 Задаёт таймаут при чтении ответа проксированного сервера. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1006 Таймаут устанавливается не на всю передачу ответа, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1007 а только между двумя операциями чтения. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1008 Если по истечении этого времени проксируемый сервер ничего не передаст, |
279 | 1009 соединение закрывается. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1010 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1011 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1012 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1013 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1014 |
789
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1015 <directive name="proxy_pass_request_body"> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1016 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1017 <default>on</default> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1018 <context>http</context> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1019 <context>server</context> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1020 <context>location</context> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1021 |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1022 <para> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1023 Если запрещено, то исходное тело запроса не будет передано |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1024 на проксируемый сервер. |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1025 <example> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1026 location /x-accel-redirect-here/ { |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1027 proxy_method GET; |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1028 proxy_pass_request_body off; |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1029 proxy_set_header Content-Length ""; |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1030 |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1031 proxy_pass ... |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1032 } |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1033 </example> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1034 См. также директивы <link id="proxy_set_header"/> и |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1035 <link id="proxy_pass_request_headers"/>. |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1036 </para> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1037 |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1038 </directive> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1039 |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1040 |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1041 <directive name="proxy_pass_request_headers"> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1042 <syntax><literal>on</literal> | <literal>off</literal></syntax> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1043 <default>on</default> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1044 <context>http</context> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1045 <context>server</context> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1046 <context>location</context> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1047 |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1048 <para> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1049 Если запрещено, то поля заголовка исходного запроса не будут переданы на |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1050 проксируемый сервер. |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1051 <example> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1052 location /x-accel-redirect-here/ { |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1053 proxy_method GET; |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1054 proxy_pass_request_headers off; |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1055 proxy_pass_request_body off; |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1056 |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1057 proxy_pass ... |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1058 } |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1059 </example> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1060 См. также директивы <link id="proxy_set_header"/> и |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1061 <link id="proxy_pass_request_body"/>. |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1062 </para> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1063 |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1064 </directive> |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1065 |
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1066 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1067 <directive name="proxy_redirect"> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1068 <syntax><literal>default</literal></syntax> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1069 <syntax><literal>off</literal></syntax> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1070 <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
|
1071 <default>default</default> |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1072 <context>http</context> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1073 <context>server</context> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1074 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1075 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1076 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1077 Задаёт текст, который нужно изменить в полях заголовка |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1078 <header>Location</header> и <header>Refresh</header> в ответе |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1079 проксируемого сервера. |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1080 Предположим, проксируемый сервер вернул поле заголовка |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1081 “<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
|
1082 Директива |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1083 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1084 proxy_redirect http://localhost:8000/two/ http://frontend/one/; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1085 </example> |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1086 перепишет эту строку в виде |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1087 “<literal>Location: http://frontend/one/some/uri/</literal>”. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1088 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1089 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1090 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1091 В заменяемой строке можно не указывать имя сервера: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1092 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1093 proxy_redirect http://localhost:8000/two/ /; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1094 </example> |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1095 тогда будет подставлено основное имя сервера и порт, если он отличен от 80. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1096 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1097 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1098 <para> |
279 | 1099 Стандартная замена, задаваемая параметром <literal>default</literal>, |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1100 использует параметры директив |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1101 <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
|
1102 <link id="proxy_pass"/>. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1103 Поэтому две нижеприведённые конфигурации одинаковы: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1104 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1105 location /one/ { |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1106 proxy_pass http://upstream:port/two/; |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1107 proxy_redirect default; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1108 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1109 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1110 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1111 location /one/ { |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1112 proxy_pass http://upstream:port/two/; |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1113 proxy_redirect http://upstream:port/two/ /one/; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1114 </example> |
279 | 1115 Параметр <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
|
1116 используются переменные. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1117 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1118 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1119 <para> |
279 | 1120 В строке <value>замена</value> можно использовать переменные: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1121 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1122 proxy_redirect http://localhost:8000/ http://$host:$server_port/; |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1123 </example> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1124 </para> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1125 |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1126 <para> |
279 | 1127 В строке <value>перенаправление</value> тоже можно использовать (1.1.11) |
1128 переменные: | |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1129 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1130 proxy_redirect http://$proxy_host:8000/ /; |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1131 </example> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1132 </para> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1133 |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1134 <para> |
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1135 Директиву также можно задать (1.1.11) при помощи регулярных выражений. |
271 | 1136 При этом <value>перенаправление</value> должно начинаться либо с символа |
1137 “<literal>~</literal>”, если при сравнении следует учитывать регистр символов, | |
1138 либо с символов “<literal>~*</literal>”, если регистр символов учитывать | |
1139 не нужно. | |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1140 Регулярное выражение может содержать именованные и позиционные выделения, |
271 | 1141 а <value>замена</value> ссылаться на них: |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1142 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1143 proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1144 proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1145 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1146 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1147 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1148 <para> |
279 | 1149 Директив <literal>proxy_redirect</literal> может быть несколько: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1150 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1151 proxy_redirect default; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1152 proxy_redirect http://localhost:8000/ /; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1153 proxy_redirect http://www.example.com/ /; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1154 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1155 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1156 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1157 <para> |
279 | 1158 Параметр <literal>off</literal> запрещает все директивы |
271 | 1159 <literal>proxy_redirect</literal> |
238
e33fc8541217
- "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents:
222
diff
changeset
|
1160 на данном уровне: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1161 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1162 proxy_redirect off; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1163 proxy_redirect default; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1164 proxy_redirect http://localhost:8000/ /; |
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1165 proxy_redirect http://www.example.com/ /; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1166 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1167 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1168 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1169 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1170 С помощью этой директивы можно также добавлять имя хоста к относительным |
256
c78b2d6fe261
Use another term for "redirect".
Ruslan Ermilov <ru@nginx.com>
parents:
238
diff
changeset
|
1171 перенаправлениям, выдаваемым проксируемым сервером: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1172 <example> |
351
a4fa80755eab
Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents:
316
diff
changeset
|
1173 proxy_redirect / /; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1174 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1175 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1176 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1177 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1178 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1179 |
773
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1180 <directive name="proxy_send_lowat"> |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1181 <syntax><value>размер</value></syntax> |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1182 <default>0</default> |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1183 <context>http</context> |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1184 <context>server</context> |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1185 <context>location</context> |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1186 |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1187 <para> |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1188 При установке в ненулевое значение nginx будет пытаться минимизировать |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1189 число операций отправки на исходящих соединениях с проксируемым сервером либо |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1190 при помощи флага <c-def>NOTE_LOWAT</c-def> метода |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1191 <link doc="../events.xml" id="kqueue"/>, |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1192 либо при помощи параметра сокета <c-def>SO_SNDLOWAT</c-def>, |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1193 с указанным <value>размером</value>. |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1194 </para> |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1195 |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1196 <para> |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1197 Эта директива игнорируется на Linux, Solaris и Windows. |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1198 </para> |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1199 |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1200 </directive> |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1201 |
24b1b0101250
Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents:
772
diff
changeset
|
1202 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1203 <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
|
1204 <syntax><value>время</value></syntax> |
279 | 1205 <default>60s</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1206 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1207 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1208 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1209 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1210 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1211 Задаёт таймаут при передаче запроса проксированному серверу. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1212 Таймаут устанавливается не на всю передачу запроса, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1213 а только между двумя операциями записи. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1214 Если по истечении этого времени проксируемый сервер не примет новых данных, |
279 | 1215 соединение закрывается. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1216 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1217 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1218 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1219 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1220 |
787
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1221 <directive name="proxy_set_body"> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1222 <syntax><value>значение</value></syntax> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1223 <default/> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1224 <context>http</context> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1225 <context>server</context> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1226 <context>location</context> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1227 |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1228 <para> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1229 Позволяет переопределить тело запроса, передаваемое на проксируемый сервер. |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1230 В качестве значения можно использовать текст, переменные и их комбинации. |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1231 </para> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1232 |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1233 </directive> |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1234 |
180a64c709d8
Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents:
773
diff
changeset
|
1235 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1236 <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
|
1237 <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
|
1238 <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
|
1239 <default>Connection close</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1240 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1241 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1242 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1243 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1244 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1245 Позволяет переопределять или добавлять поля заголовка запроса, |
789
1063836dacea
Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents:
787
diff
changeset
|
1246 <link id="proxy_pass_request_headers">передаваемые</link> проксируемому серверу. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1247 В качестве значения можно использовать текст, переменные и их комбинации. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1248 Директивы наследуются с предыдущего уровня при условии, что на данном |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1249 уровне не описаны свои директивы <literal>proxy_set_header</literal>. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1250 По умолчанию переопределяются только два поля: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1251 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1252 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
|
1253 proxy_set_header Connection close; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1254 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1255 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1256 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1257 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1258 Неизменённое поле заголовка запроса <header>Host</header> можно передать так: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1259 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1260 proxy_set_header Host $http_host; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1261 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1262 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1263 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1264 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1265 Однако, если это поле отсутствует в заголовке запроса клиента, то ничего |
364 | 1266 передаваться не будет. |
1267 В этом случае лучше воспользоваться переменной <var>$host</var>—её | |
1268 значение равно имени сервера в поле <header>Host</header> | |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1269 заголовка запроса, или же основному имени сервера, если поля нет: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1270 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1271 proxy_set_header Host $host; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1272 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1273 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1274 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1275 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1276 Кроме того, можно передать имя сервера вместе с портом проксируемого сервера: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1277 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1278 proxy_set_header Host $host:$proxy_port; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1279 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1280 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1281 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1282 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1283 Если значение поля заголовка — пустая строка, то поле вообще |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1284 не будет передаваться проксируемому серверу: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1285 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1286 proxy_set_header Accept-Encoding ""; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1287 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1288 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1289 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1290 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1291 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1292 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1293 <directive name="proxy_ssl_session_reuse"> |
271 | 1294 <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
|
1295 <default>on</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1296 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1297 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1298 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1299 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1300 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1301 Определяет, использовать ли повторно SSL-сессии при |
364 | 1302 работе с проксированным сервером. |
1303 Если в логах появляются ошибки | |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1304 “<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
|
1305 то можно попробовать выключить |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1306 повторное использование сессий. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1307 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1308 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1309 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1310 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1311 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1312 <directive name="proxy_store"> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1313 <syntax> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1314 <literal>on</literal> | |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1315 <literal>off</literal> | |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1316 <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
|
1317 <default>off</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1318 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1319 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1320 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1321 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1322 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1323 Разрешает сохранение на диск файлов. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1324 Параметр <literal>on</literal> сохраняет файлы в соответствии с путями, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1325 указанными в директивах |
106
56457a474903
If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents:
102
diff
changeset
|
1326 <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
|
1327 <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
|
1328 Параметр <literal>off</literal> запрещает сохранение файлов. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1329 Кроме того, имя файла можно задать явно с помощью строки с переменными: |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1330 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1331 proxy_store /data/www$original_uri; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1332 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1333 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1334 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1335 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1336 Время изменения файлов выставляется согласно полученному полю |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1337 <header>Last-Modified</header> в заголовке ответа. |
279 | 1338 Ответ сначала записывается во временный файл, а потом этот файл |
1339 переименовывается. | |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1340 Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1341 могут располагаться на разных файловых системах, но нужно учитывать, |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1342 что в этом случае вместо дешёвой операции переименовывания в пределах |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1343 одной файловой системы файл копируется с одной файловой системы на другую. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1344 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1345 системе, что и каталог с временными файлами, задаваемый директивой |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1346 <link id="proxy_temp_path"/> для данного location. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1347 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1348 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1349 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1350 Директиву можно использовать для создания локальных копий статических |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1351 неизменяемых файлов, например, так: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1352 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1353 location /images/ { |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1354 root /data/www; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1355 open_file_cache_errors off; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1356 error_page 404 = /fetch$uri; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1357 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1358 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1359 location /fetch/ { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1360 internal; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1361 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1362 proxy_pass http://backend/; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1363 proxy_store on; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1364 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
|
1365 proxy_temp_path /data/temp; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1366 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1367 alias /data/www/; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1368 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1369 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1370 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1371 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1372 <para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1373 или так: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1374 <example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1375 location /images/ { |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1376 root /data/www; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1377 error_page 404 = @fetch; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1378 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1379 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1380 location @fetch { |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1381 internal; |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1382 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1383 proxy_pass http://backend; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1384 proxy_store on; |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1385 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
|
1386 proxy_temp_path /data/temp; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1387 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1388 root /data/www; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1389 } |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1390 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1391 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1392 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1393 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1394 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1395 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1396 <directive name="proxy_store_access"> |
271 | 1397 <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
|
1398 <default>user:rw</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1399 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1400 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1401 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1402 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1403 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1404 Задаёт права доступа для создаваемых файлов и каталогов, например, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1405 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1406 proxy_store_access user:rw group:rw all:r; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1407 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1408 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1409 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1410 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1411 Если заданы какие-либо права для <literal>group</literal> или |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1412 <literal>all</literal>, то права для <literal>user</literal> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1413 указывать необязательно: |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1414 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1415 proxy_store_access group:rw all:r; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1416 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1417 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1418 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1419 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1420 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1421 |
405
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1422 <directive name="proxy_temp_file_write_size"> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1423 <syntax><value>размер</value></syntax> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1424 <default>8k|16k</default> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1425 <context>http</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1426 <context>server</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1427 <context>location</context> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1428 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1429 <para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1430 Ограничивает <value>размер</value> данных, сбрасываемых во временный файл |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1431 за один раз, при включённой буферизации ответов проксируемого сервера |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1432 во временные файлы. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1433 По умолчанию <value>размер</value> ограничен двумя буферами, заданными |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1434 директивами <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1435 Максимальный размер временного файла задаётся директивой |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1436 <link id="proxy_max_temp_file_size"/>. |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1437 </para> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1438 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1439 </directive> |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1440 |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1441 |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1442 <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
|
1443 <syntax> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1444 <value>путь</value> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1445 [<value>уровень1</value> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1446 [<value>уровень2</value> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1447 [<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
|
1448 <default>proxy_temp</default> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1449 <context>http</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1450 <context>server</context> |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1451 <context>location</context> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1452 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1453 <para> |
405
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1454 Задаёт имя каталога для хранения временных файлов с данными, |
781b23ba3b0a
Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents:
364
diff
changeset
|
1455 полученными от проксируемых серверов. |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1456 В каталоге может использоваться иерархия подкаталогов до трёх уровней. |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1457 Например, при такой конфигурации |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1458 <example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1459 proxy_temp_path /spool/nginx/proxy_temp 1 2; |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1460 </example> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1461 временный файл будет следующего вида: |
98 | 1462 <example> |
279 | 1463 /spool/nginx/proxy_temp/<emphasis>7</emphasis>/<emphasis>45</emphasis>/00000123<emphasis>457</emphasis> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1464 </example> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1465 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1466 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1467 </directive> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1468 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1469 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1470 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1471 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1472 <section id="variables" name="Встроенные переменные"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1473 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1474 <para> |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1475 В модуле <literal>ngx_http_proxy_module</literal> есть встроенные переменные, |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1476 которые можно использовать для формирования заголовков с помощью директивы |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1477 <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
|
1478 <list type="tag"> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1479 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1480 <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
|
1481 <tag-desc>имя проксируемого хоста и порт;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1482 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1483 <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
|
1484 <tag-desc>порт проксируемого хоста;</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1485 |
273
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1486 <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
|
1487 <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
|
1488 и добавленная к нему через запятую переменная <var>$remote_addr</var>. |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1489 Если же поля <header>X-Forwarded-For</header> в заголовке запроса клиента нет, |
44ab4026d9f5
Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents:
271
diff
changeset
|
1490 то переменная <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
|
1491 равна переменной <var>$remote_addr</var>.</tag-desc> |
76
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1492 </list> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1493 </para> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1494 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1495 </section> |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1496 |
4a4caa566120
Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff
changeset
|
1497 </module> |