annotate xml/ru/docs/http/ngx_http_proxy_module.xml @ 1128:1594ed379f1f

De-i18n'ed <commercial_version/>. Now the text of a link has to be written verbatim.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 21 Mar 2014 13:15:42 +0400
parents d708d213959a
children 666052986b99
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
222
bfe3eff81d04 Removed redundant encoding specification.
Ruslan Ermilov <ru@nginx.com>
parents: 135
diff changeset
1 <?xml version="1.0"?>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
2
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
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="ru"
1116
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
13 rev="17">
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">
815
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 799
diff changeset
43 <syntax><value>адрес</value> | <literal>off</literal></syntax>
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 799
diff changeset
44 <default>off</default>
772
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 исходящих соединениях с проксируемым сервером.
815
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 799
diff changeset
53 В значении параметра допустимо использование переменных (1.3.12).
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 799
diff changeset
54 Специальное значение <literal>off</literal> (1.3.12) отменяет действие
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 799
diff changeset
55 унаследованной с предыдущего уровня конфигурации
ed29fd8be462 *_bind: variables support and inheritance.
Ruslan Ermilov <ru@nginx.com>
parents: 799
diff changeset
56 директивы <literal>proxy_bind</literal>, позволяя системе
959
fbb4cc6f8c3d Text review of ngx_http_proxy_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
57 самостоятельно выбирать локальный IP-адрес.
772
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
58 </para>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
59
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
60 </directive>
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
61
ce121bf644f5 Documented "bind" directive in memcached, fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 625
diff changeset
62
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
63 <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
64 <syntax><value>размер</value></syntax>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
65 <default>4k|8k</default>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
66 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
67 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
68 <context>location</context>
76
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 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
71 Задаёт <value>размер</value> буфера, в который будет читаться
76
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 В этой части ответа находится, как правило, небольшой заголовок ответа.
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 <link id="proxy_buffers"/>, однако его можно сделать меньше.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
76 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
77
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
78 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
79
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
80
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
81 <directive name="proxy_buffering">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
82 <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
83 <default>on</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
84 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
85 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
86 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
87
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
88 <para>
405
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
89 Разрешает или запрещает использовать буферизацию ответов проксируемого сервера.
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
90 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
91
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
92 <para>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
93 Если буферизация включена, то nginx принимает ответ проксируемого сервера
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
94 как можно быстрее, сохраняя его в буферы, заданные директивами
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
95 <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
96 Если ответ не вмещается целиком в память, то его часть может быть записана
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
97 на диск во <link id="proxy_temp_path">временный файл</link>.
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
98 Запись во временные файлы контролируется директивами
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
99 <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
100 <link id="proxy_temp_file_write_size"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
101 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
102
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
103 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
104 Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
105 по мере его поступления.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
106 nginx не пытается считать весь ответ проксируемого сервера.
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
107 Максимальный размер данных, который nginx может принять от сервера
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
108 за один раз, задаётся директивой <link id="proxy_buffer_size"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
109 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
110
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
111 <para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
112 Буферизация может быть также включена или выключена путём передачи
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
113 значения “<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
114 <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
115 Эту возможность можно запретить с помощью директивы
992
7cc496641627 Removed extraneous links.
Ruslan Ermilov <ru@nginx.com>
parents: 991
diff changeset
116 <link id="proxy_ignore_headers"/>.
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
117 </para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
118
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
119 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
120
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
121
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
122 <directive name="proxy_buffers">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
123 <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
124 <default>8 4k|8k</default>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
125 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
126 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
127 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
128
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
129 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
130 Задаёт <value>число</value> и <value>размер</value> буферов
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
131 для одного соединения,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
132 в которые будет читаться ответ, получаемый от проксируемого сервера.
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
133 По умолчанию размер одного буфера равен размеру страницы.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
134 В зависимости от платформы это или 4K, или 8K.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
135 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
136
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
137 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
138
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
139
405
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
140 <directive name="proxy_busy_buffers_size">
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
141 <syntax><value>размер</value></syntax>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
142 <default>8k|16k</default>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
143 <context>http</context>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
144 <context>server</context>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
145 <context>location</context>
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 <para>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
148 При включённой <link id="proxy_buffering">буферизации</link> ответов
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 буферов, которые могут быть заняты для отправки ответа клиенту, пока
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
151 ответ ещё не прочитан целиком.
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 и, при необходимости, буферизации части ответа во временный файл.
959
fbb4cc6f8c3d Text review of ngx_http_proxy_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
154 По умолчанию <value>размер</value> ограничен величиной двух буферов, заданных
405
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
155 директивами <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
156 </para>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
157
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
158 </directive>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
159
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
160
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
161 <directive name="proxy_cache">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
162 <syntax><value>зона</value> | <literal>off</literal></syntax>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
163 <default>off</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
164 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
165 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
166 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
167
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
168 <para>
575
ebcb351d9eb3 Consistently using the term "shared memory zone".
Ruslan Ermilov <ru@nginx.com>
parents: 535
diff changeset
169 Задаёт зону разделяемой памяти, используемой для кэширования.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
170 Одна и та же зона может использоваться в нескольких местах.
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
171 Параметр <literal>off</literal> запрещает кэширование, унаследованное
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
172 с предыдущего уровня конфигурации.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
173 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
174
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
175 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
176
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
177
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
178 <directive name="proxy_cache_bypass">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
179 <syntax><value>строка</value> ...</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
180 <default/>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
181 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
182 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
183 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
184
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
185 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
186 Задаёт условия, при которых ответ не будет браться из кэша.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
187 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
188 то ответ не берётся из кэша:
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
189 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
190 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
191 proxy_cache_bypass $http_pragma $http_authorization;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
192 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
193 Можно использовать совместно с директивой <link id="proxy_no_cache"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
194 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
195
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
196 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
197
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
198
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
199 <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
200 <syntax><value>строка</value></syntax>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
201 <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
202 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
203 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
204 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
205
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
206 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
207 Задаёт ключ для кэширования, например,
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
208 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
209 proxy_cache_key "$host$request_uri $cookie_user";
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
210 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
211 По умолчанию значение директивы близко к строке
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
212 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
213 proxy_cache_key $scheme$proxy_host$uri$is_args$args;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
214 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
215 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
216
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
217 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
218
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
219
302
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
220 <directive name="proxy_cache_lock">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
221 <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
222 <default>off</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
223 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
224 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
225 <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
226 <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
227
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
228 <para>
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 заполнить новый элемент кэша, идентифицируемый согласно директиве
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
231 <link id="proxy_cache_key"/>, передав запрос на проксируемый сервер.
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 появления ответа в кэше, либо освобождения блокировки
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 <link id="proxy_cache_lock_timeout"/>.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
236 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
237
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
238 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
239
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
240
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
241 <directive name="proxy_cache_lock_timeout">
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
242 <syntax><value>время</value></syntax>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
243 <default>5s</default>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
244 <context>http</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
245 <context>server</context>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
246 <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
247 <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
248
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
249 <para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
250 Задаёт таймаут для <link id="proxy_cache_lock"/>.
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
251 </para>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
252
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
253 </directive>
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
254
df728215db07 Documented "proxy_cache_lock", "proxy_cache_lock_timeout",
Ruslan Ermilov <ru@nginx.com>
parents: 296
diff changeset
255
790
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
256 <directive name="proxy_cache_methods">
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
257 <syntax>
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
258 <literal>GET</literal> |
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
259 <literal>HEAD</literal> |
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
260 <literal>POST</literal>
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
261 ...</syntax>
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
262 <default>GET HEAD</default>
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
263 <context>http</context>
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
264 <context>server</context>
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
265 <context>location</context>
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
266 <appeared-in>0.7.59</appeared-in>
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 <para>
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
269 Если метод запроса клиента указан в этой директиве,
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 Методы “<literal>GET</literal>” и “<literal>HEAD</literal>” всегда добавляются
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 См. также директиву <link id="proxy_no_cache"/>.
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
274 </para>
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
275
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
276 </directive>
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
277
ae776a353984 Documented "proxy_cache_methods" directive.
Vladimir Homutov <vl@nginx.com>
parents: 789
diff changeset
278
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
279 <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
280 <syntax><value>число</value></syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
281 <default>1</default>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
282 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
283 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
284 <context>location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
285
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
286 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
287 Задаёт <value>число</value> запросов, после которого ответ будет закэширован.
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
288 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
289
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
290 </directive>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
291
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
292
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
293 <directive name="proxy_cache_path">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
294 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
295 <value>путь</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
296 [<literal>levels</literal>=<value>уровни</value>]
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
297 <literal>keys_zone</literal>=<value>имя</value>:<value>размер</value>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
298 [<literal>inactive</literal>=<value>время</value>]
508
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
299 [<literal>max_size</literal>=<value>размер</value>]
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
300 [<literal>loader_files</literal>=<value>число</value>]
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
301 [<literal>loader_sleep</literal>=<value>время</value>]
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
302 [<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
303 <default/>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
304 <context>http</context>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
305
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
306 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
307 Задаёт путь и другие параметры кэша.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
308 Данные кэша хранятся в файлах.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
309 Ключом и именем файла в кэше является результат функции MD5
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
310 от проксированного URL.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
311 Параметр <literal>levels</literal> задаёт уровни иерархии кэша,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
312 например, при использовании
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
313 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
314 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
315 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
316 имена файлов в кэше будут такого вида:
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
317 <example>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
318 /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
319 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
320 </para>
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 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
323 Кэшируемый ответ сначала записывается во временный файл, а потом этот файл
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
324 переименовывается.
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
325 Начиная с версии 0.8.9, временные файлы и кэш
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 959
diff changeset
326 могут располагаться на разных файловых системах.
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 959
diff changeset
327 Однако нужно учитывать,
76
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 одной файловой системы файл копируется с одной файловой системы на другую.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
330 Поэтому лучше, если кэш будет находиться на той же файловой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
331 системе, что и каталог с временными файлами, задаваемый директивой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
332 <link id="proxy_temp_path"/> для данного location.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
333 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
334
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
335 <para>
575
ebcb351d9eb3 Consistently using the term "shared memory zone".
Ruslan Ermilov <ru@nginx.com>
parents: 535
diff changeset
336 Кроме того, все активные ключи и информация о данных хранятся в зоне
ebcb351d9eb3 Consistently using the term "shared memory zone".
Ruslan Ermilov <ru@nginx.com>
parents: 535
diff changeset
337 разделяемой памяти, <value>имя</value> и <value>размер</value> которой
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
338 задаются параметром <literal>keys_zone</literal>.
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
339 Если к данным кэша не обращаются в течение времени, заданного параметром
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
340 <literal>inactive</literal>, то данные удаляются, независимо от их свежести.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
341 По умолчанию <literal>inactive</literal> равен 10 минутам.
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
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
344 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
345 Специальный процесс “cache manager” следит за максимальным размером кэша,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
346 заданным параметром <literal>max_size</literal>, и при превышении
507
d00a4f9b1c5d Better translation of "LRU".
Ruslan Ermilov <ru@nginx.com>
parents: 506
diff changeset
347 его размеров удаляет наименее востребованные данные.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
348 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
349
508
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
350 <para>
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
351 Через минуту после старта активируется специальный процесс “cache loader”,
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
352 который загружает в зону кэша информацию о ранее закэшированных данных,
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 Загрузка происходит итерациями.
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
355 За одну итерацию загружается не более <literal>loader_files</literal>
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
356 элементов (по умолчанию 100).
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
357 Кроме того, время работы одной итерации ограничено параметром
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
358 <literal>loader_threshold</literal> (по умолчанию 200 миллисекунд).
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
359 Между итерациями делается пауза на время, заданное параметром
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
360 <literal>loader_sleep</literal> (по умолчанию 50 миллисекунд).
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
361 </para>
5e332fafd228 Documented "cache loader" and its parameters.
Ruslan Ermilov <ru@nginx.com>
parents: 507
diff changeset
362
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
363 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
364
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
365
1116
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
366 <directive name="proxy_cache_purge">
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
367 <syntax>строка ...</syntax>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
368 <default/>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
369 <context>http</context>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
370 <context>server</context>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
371 <context>location</context>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
372 <appeared-in>1.5.7</appeared-in>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
373
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
374 <para>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
375 Задаёт условия, при которых запрос будет считаться запросом
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
376 на очистку кэша.
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
377 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
378 то запись в кэше с соответствующим
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
379 <link id="proxy_cache_key">ключём кэширования</link> удаляется.
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
380 Результат успешной операции определяется возвращением ответа
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
381 <http-status code="204" text="No Content"/>.
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
382 </para>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
383
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
384 <para>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
385 Если <link id="proxy_cache_key">ключ кэширования</link>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
386 запроса на очистку заканчивается
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
387 звёздочкой (“<literal>*</literal>”), то все записи в кэше, соответствующие
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
388 этой маске, будут удалены из кэша.
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
389 </para>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
390
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
391 <para>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
392 Пример конфигурации:
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
393 <example>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
394 proxy_cache_path /data/nginx/cache keys_zone=cache_zone:10m;
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
395
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
396 map $request_method $purge_method {
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
397 PURGE 1;
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
398 default 0;
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
399 }
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
400
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
401 server {
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
402 ...
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
403 location / {
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
404 proxy_pass http://backend;
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
405 proxy_cache cache_zone;
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
406 proxy_cache_key $uri;
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
407 proxy_cache_purge $purge_method;
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
408 }
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
409 }
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
410 </example>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
411 <note>
1128
1594ed379f1f De-i18n'ed <commercial_version/>.
Ruslan Ermilov <ru@nginx.com>
parents: 1117
diff changeset
412 Функциональность доступна как часть
1594ed379f1f De-i18n'ed <commercial_version/>.
Ruslan Ermilov <ru@nginx.com>
parents: 1117
diff changeset
413 <commercial_version>коммерческой подписки</commercial_version>.
1116
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
414 </note>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
415 </para>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
416
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
417 </directive>
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
418
d882c6f3323d FastCGI and Proxy: translated the "_cache_purge" directives into RU.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1016
diff changeset
419
1016
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
420 <directive name="proxy_cache_revalidate">
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
421 <syntax><literal>on</literal> | <literal>off</literal></syntax>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
422 <default>off</default>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
423 <context>http</context>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
424 <context>server</context>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
425 <context>location</context>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
426 <appeared-in>1.5.7</appeared-in>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
427
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
428 <para>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
429 Разрешает ревалидацию просроченных элементов кэша при помощи
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
430 условных запросов с полем заголовка <header>If-Modified-Since</header>.
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
431 </para>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
432
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
433 </directive>
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
434
2d8269d8fea8 Translated documentation on cache revalidation into russian.
Vladimir Homutov <vl@nginx.com>
parents: 1005
diff changeset
435
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
436 <directive name="proxy_cache_use_stale">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
437 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
438 <literal>error</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
439 <literal>timeout</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
440 <literal>invalid_header</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
441 <literal>updating</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
442 <literal>http_500</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
443 <literal>http_502</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
444 <literal>http_503</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
445 <literal>http_504</literal> |
917
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
446 <literal>http_403</literal> |
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
447 <literal>http_404</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
448 <literal>off</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
449 ...</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
450 <default>off</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
451 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
452 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
453 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
454
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
455 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
456 Определяет, в каких случаях можно использовать
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
457 устаревший закэшированный ответ, если при работе с проксированным
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
458 сервером возникла ошибка.
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
459 Параметры директивы совпадают с параметрами
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
460 директивы <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
461 </para>
695f83494c19 Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 417
diff changeset
462
695f83494c19 Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 417
diff changeset
463 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
464 Кроме того, дополнительный параметр <literal>updating</literal>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
465 разрешает использовать устаревший закэшированный ответ,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
466 если на данный момент он уже обновляется.
504
695f83494c19 Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 417
diff changeset
467 Это позволяет минимизировать число обращений к проксированным серверам
695f83494c19 Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 417
diff changeset
468 при обновлении закэшированных данных.
695f83494c19 Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 417
diff changeset
469 </para>
695f83494c19 Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 417
diff changeset
470
695f83494c19 Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 417
diff changeset
471 <para>
695f83494c19 Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 417
diff changeset
472 Чтобы минимизировать число обращений к проксированным серверам при
695f83494c19 Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 417
diff changeset
473 заполнении нового элемента кэша, можно воспользоваться директивой
695f83494c19 Emphasized on what the "updating" parameter of the "proxy_cache_use_stale"
Ruslan Ermilov <ru@nginx.com>
parents: 417
diff changeset
474 <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
475 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
476
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
477 </directive>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
478
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
479
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
480 <directive name="proxy_cache_valid">
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
481 <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
482 <default/>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
483 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
484 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
485 <context>location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
486
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
487 <para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
488 Задаёт время кэширования для разных кодов ответа.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
489 Например, директивы
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
490 <example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
491 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
492 proxy_cache_valid 404 1m;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
493 </example>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 959
diff changeset
494 задают время кэширования 10 минут для ответов с кодами 200 и 302
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
495 и 1 минуту для ответов с кодом 404.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
496 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
497
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
498 <para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
499 Если указано только <value>время</value> кэширования,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
500 <example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
501 proxy_cache_valid 5m;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
502 </example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
503 то кэшируются только ответы 200, 301 и 302.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
504 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
505
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
506 <para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
507 Кроме того, можно кэшировать любые ответы с помощью параметра
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
508 <literal>any</literal>:
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
509 <example>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
510 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
511 proxy_cache_valid 301 1h;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
512 proxy_cache_valid any 1m;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
513 </example>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
514 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
515
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
516 <para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
517 Параметры кэширования могут также быть заданы непосредственно
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
518 в заголовке ответа.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
519 Такой способ приоритетнее, чем задание времени кэширования с помощью директивы.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
520 Поле заголовка <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
521 ответа в секундах.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
522 Значение 0 запрещает кэшировать ответ.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
523 Если значение начинается с префикса <literal>@</literal>, оно задаёт абсолютное
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
524 время в секундах с начала эпохи, до которого ответ может быть закэширован.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
525 Если в заголовке нет поля <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
526 параметры кэширования определяются по полям заголовка
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
527 <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
528 Ответ, в заголовке которого есть поле <header>Set-Cookie</header>,
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
529 не будет кэшироваться.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
530 Обработка одного или более из этих полей заголовка может быть отключена
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
531 при помощи директивы <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
532 </para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
533
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
534 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
535
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
536
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
537 <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
538 <syntax><value>время</value></syntax>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
539 <default>60s</default>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
540 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
541 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
542 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
543
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
544 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
545 Задаёт таймаут для установления соединения с проксированным сервером.
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
546 Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
547 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
548
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
549 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
550
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
551
417
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
552 <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
553 <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
554 <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
555 <default>off</default>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
556 <context>http</context>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
557 <context>server</context>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
558 <context>location</context>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
559 <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
560
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
561 <para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
562 Задаёт текст, который нужно изменить в атрибуте <literal>domain</literal>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
563 полей <header>Set-Cookie</header> заголовка ответа проксируемого сервера.
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 <header>Set-Cookie</header> с атрибутом
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
566 “<literal>domain=localhost</literal>”.
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 <example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
569 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
570 </example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
571 перепишет данный атрибут в виде
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
572 “<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
573 </para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
574
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
575 <para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
576 Точка в начале строк <value>домен</value> и <value>замена</value>,
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
577 а равно как и в атрибуте <literal>domain</literal> игнорируется.
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
578 Регистр значения не имеет.
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
579 </para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
580
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
581 <para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
582 В строках <value>домен</value> и <value>замена</value> можно использовать
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
583 переменные:
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_domain www.$host $host;
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 Директиву также можно задать при помощи регулярных выражений.
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
591 При этом <value>домен</value> должен начинаться с символа
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
592 “<literal>~</literal>”.
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
593 Регулярное выражение может содержать именованные и позиционные выделения,
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
594 а <value>замена</value> ссылаться на них:
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
595 <example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
596 proxy_cookie_domain ~\.(?P&lt;sl_domain&gt;[-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
597 </example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
598 </para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
599
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
600 <para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
601 Директив <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
602 <example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
603 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
604 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
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 <para>
959
fbb4cc6f8c3d Text review of ngx_http_proxy_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
609 Параметр <literal>off</literal> отменяет действие всех директив
417
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
610 <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
611 на данном уровне:
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
612 <example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
613 proxy_cookie_domain off;
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
614 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
615 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
616 </example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
617 </para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
618
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
619 </directive>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
620
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
621
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
622 <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
623 <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
624 <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
625 <default>off</default>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
626 <context>http</context>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
627 <context>server</context>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
628 <context>location</context>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
629 <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
630
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
631 <para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
632 Задаёт текст, который нужно изменить в атрибуте <literal>path</literal>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
633 полей <header>Set-Cookie</header> заголовка ответа проксируемого сервера.
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
634 Предположим, проксируемый сервер вернул поле заголовка
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
635 <header>Set-Cookie</header> с атрибутом
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
636 “<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
637 Директива
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
638 <example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
639 proxy_cookie_path /two/ /;
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
640 </example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
641 перепишет данный атрибут в виде
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
642 “<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
643 </para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
644
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
645 <para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
646 В строках <value>путь</value> и <value>замена</value> можно использовать
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
647 переменные:
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
648 <example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
649 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
650 </example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
651 </para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
652
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
653 <para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
654 Директиву также можно задать при помощи регулярных выражений.
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
655 При этом <value>путь</value> должен начинаться либо с символа
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
656 “<literal>~</literal>”, если при сравнении следует учитывать регистр символов,
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
657 либо с символов “<literal>~*</literal>”, если регистр символов учитывать
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
658 не нужно.
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
659 Регулярное выражение может содержать именованные и позиционные выделения,
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
660 а <value>замена</value> ссылаться на них:
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
661 <example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
662 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
663 </example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
664 </para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
665
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
666 <para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
667 Директив <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
668 <example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
669 proxy_cookie_path /one/ /;
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
670 proxy_cookie_path / /two/;
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
671 </example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
672 </para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
673
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
674 <para>
959
fbb4cc6f8c3d Text review of ngx_http_proxy_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
675 Параметр <literal>off</literal> отменяет действие всех директив
417
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
676 <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
677 на данном уровне:
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
678 <example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
679 proxy_cookie_path off;
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
680 proxy_cookie_path /two/ /;
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
681 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
682 </example>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
683 </para>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
684
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
685 </directive>
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
686
cbc2d1b51cb6 Documented the proxy_cookie_domain and proxy_cookie_path directives.
Ruslan Ermilov <ru@nginx.com>
parents: 405
diff changeset
687
799
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
688 <directive name="proxy_headers_hash_bucket_size">
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
689 <syntax><value>размер</value></syntax>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
690 <default>64</default>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
691 <context>http</context>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
692 <context>server</context>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
693 <context>location</context>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
694
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
695 <para>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
696 Задаёт <value>размер</value> корзины для хэш-таблиц,
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
697 используемых директивами <link id="proxy_hide_header"/>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
698 и <link id="proxy_set_header"/>.
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
699 Подробнее настройка хэш-таблиц обсуждается в отдельном
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
700 <link doc="../hash.xml">документе</link>.
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
701 </para>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
702
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
703 </directive>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
704
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
705
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
706 <directive name="proxy_headers_hash_max_size">
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
707 <syntax><value>размер</value></syntax>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
708 <default>512</default>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
709 <context>http</context>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
710 <context>server</context>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
711 <context>location</context>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
712
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
713 <para>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
714 Задаёт максимальный <value>размер</value> хэш-таблиц,
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
715 используемых директивами <link id="proxy_hide_header"/> и
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
716 <link id="proxy_set_header"/>.
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
717 Подробнее настройка хэш-таблиц обсуждается в отдельном
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
718 <link doc="../hash.xml">документе</link>.
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
719 </para>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
720
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
721 </directive>
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
722
9e5847af3b2d Documented the "proxy_headers_hash_bucket/max_size" directives.
Vladimir Homutov <vl@nginx.com>
parents: 791
diff changeset
723
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
724 <directive name="proxy_hide_header">
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
725 <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
726 <default/>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
727 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
728 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
729 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
730
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
731 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
732 По умолчанию
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
733 nginx не передаёт клиенту поля заголовка <header>Date</header>,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
734 <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
735 <header>X-Accel-...</header> из ответа проксированного сервера.
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
736 Директива <literal>proxy_hide_header</literal> задаёт дополнительные поля,
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
737 которые не будут передаваться.
291
fd85955f31aa Removed a questionable word.
Ruslan Ermilov <ru@nginx.com>
parents: 279
diff changeset
738 Если же передачу полей нужно разрешить, можно воспользоваться
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
739 директивой <link id="proxy_pass_header"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
740 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
741
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
742 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
743
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
744
316
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
745 <directive name="proxy_http_version">
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
746 <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
747 <default>1.0</default>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
748 <context>http</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
749 <context>server</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
750 <context>location</context>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
751 <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
752
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
753 <para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
754 Задаёт версию протокола HTTP для проксирования.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
755 По умолчанию используется версия 1.0.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
756 Для работы
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
757 <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
758 соединений</link> рекомендуется версия 1.1.
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
759 </para>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
760
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
761 </directive>
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
762
1fb1c077658b Documented the following directives: "keepalive", "proxy_http_version",
Ruslan Ermilov <ru@nginx.com>
parents: 310
diff changeset
763
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
764 <directive name="proxy_ignore_client_abort">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
765 <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
766 <default>off</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
767 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
768 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
769 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
770
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
771 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
772 Определяет, закрывать ли соединение с проксированным сервером
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
773 в случае, если клиент закрыл соединение, не дождавшись ответа.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
774 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
775
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
776 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
777
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
778
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
779 <directive name="proxy_ignore_headers">
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
780 <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
781 <default/>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
782 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
783 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
784 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
785
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
786 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
787 Запрещает обработку некоторых полей заголовка из ответа проксированного сервера.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
788 В директиве можно указать поля <header>X-Accel-Redirect</header>,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
789 <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
790 <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
791 <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
792 <header>Cache-Control</header> и <header>Set-Cookie</header> (0.8.44).
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
793 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
794
506
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
795 <para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
796 Если не запрещено, обработка этих полей заголовка заключается в следующем:
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
797 <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
798
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
799 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
800 <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
801 <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
802 задают параметры <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
803 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
804
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
805 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
806 <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
807 <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
808 перенаправление</link> на указанный URI;
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
809 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
810
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
811 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
812 <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
813 <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
814 скорости</link> передачи ответа клиенту;
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
815 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
816
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
817 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
818 <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
819 <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
820 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
821
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
822 <listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
823 <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
824 <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
825 ответа.
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
826 </listitem>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
827
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
828 </list>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
829 </para>
657848837328 Documented how nginx processes proxied server's response header fields
Ruslan Ermilov <ru@nginx.com>
parents: 504
diff changeset
830
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
831 </directive>
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 <directive name="proxy_intercept_errors">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
835 <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
836 <default>off</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
837 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
838 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
839 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
840
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
841 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
842 Определяет, передавать ли клиенту проксированные ответы с кодом
907
43887f41bb17 Corrected the descriptions of {proxy,fastcgi}_intercept_errors.
Ruslan Ermilov <ru@nginx.com>
parents: 849
diff changeset
843 больше либо равным 300, или же перенаправлять их на обработку nginx’у с помощью
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
844 директивы <link doc="ngx_http_core_module.xml" id="error_page"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
845 </para>
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 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
848
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
849
405
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
850 <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
851 <syntax><value>размер</value></syntax>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
852 <default>1024m</default>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
853 <context>http</context>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
854 <context>server</context>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
855 <context>location</context>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
856
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
857 <para>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
858 Если включена <link id="proxy_buffering">буферизация</link> ответов
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
859 проксируемого сервера, и ответ не вмещается целиком в буферы памяти,
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
860 заданные директивами <link id="proxy_buffer_size"/> и
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
861 <link id="proxy_buffers"/>, часть ответа может быть записана во временный файл.
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
862 Эта директива задаёт максимальный <value>размер</value> временного файла.
991
fdaafa908a31 Unified wording.
Ruslan Ermilov <ru@nginx.com>
parents: 985
diff changeset
863 Размер данных, сбрасываемых во временный файл за один раз, задаётся
405
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
864 директивой <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
865 </para>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
866
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
867 <para>
959
fbb4cc6f8c3d Text review of ngx_http_proxy_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
868 Значение 0 отключает буферизацию ответов во временные файлы.
405
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
869 </para>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
870
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
871 </directive>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
872
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
873
787
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
874 <directive name="proxy_method">
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
875 <syntax><value>метод</value></syntax>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
876 <default/>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
877 <context>http</context>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
878 <context>server</context>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
879 <context>location</context>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
880
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
881 <para>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
882 Задаёт HTTP-<value>метод</value>, который будет использоваться
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
883 в передаваемых на проксируемый сервер запросах вместо метода
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
884 из клиентского запроса.
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
885 </para>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
886
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
887 </directive>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
888
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
889
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
890 <directive name="proxy_next_upstream">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
891 <syntax>
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
892 <literal>error</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
893 <literal>timeout</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
894 <literal>invalid_header</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
895 <literal>http_500</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
896 <literal>http_502</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
897 <literal>http_503</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
898 <literal>http_504</literal> |
917
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
899 <literal>http_403</literal> |
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
900 <literal>http_404</literal> |
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
901 <literal>off</literal>
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
902 ...</syntax>
102
c76a257f3fd4 The directive name is now automatically printed in <default> and <syntax>.
Ruslan Ermilov <ru@nginx.com>
parents: 99
diff changeset
903 <default>error timeout</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
904 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
905 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
906 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
907
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
908 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
909 Определяет, в каких случаях запрос будет передан следующему серверу:
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
910 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
911
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
912 <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
913 <tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
914 чтения заголовка ответа сервера;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
915
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
916 <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
917 <tag-desc>произошёл таймаут во время соединения с сервером,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
918 передачи ему запроса или чтения заголовка ответа сервера;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
919
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
920 <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
921 <tag-desc>сервер вернул пустой или неверный ответ;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
922
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
923 <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
924 <tag-desc>сервер вернул ответ с кодом 500;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
925
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
926 <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
927 <tag-desc>сервер вернул ответ с кодом 502;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
928
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
929 <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
930 <tag-desc>сервер вернул ответ с кодом 503;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
931
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
932 <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
933 <tag-desc>сервер вернул ответ с кодом 504;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
934
917
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
935 <tag-name><literal>http_403</literal></tag-name>
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
936 <tag-desc>сервер вернул ответ с кодом 403;</tag-desc>
e26a18eb5ccd Documented http_403 in proxy_next_upstream and friends.
Maxim Dounin <mdounin@mdounin.ru>
parents: 907
diff changeset
937
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
938 <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
939 <tag-desc>сервер вернул ответ с кодом 404;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
940
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
941 <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
942 <tag-desc>запрещает передачу запроса следующему серверу.</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
943
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
944 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
945 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
946
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
947 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
948 Необходимо понимать, что передача запроса следующему серверу возможна
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
949 только при условии, что клиенту ещё ничего не передавалось.
959
fbb4cc6f8c3d Text review of ngx_http_proxy_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
950 То есть, если ошибка или таймаут возникли в середине передачи ответа
fbb4cc6f8c3d Text review of ngx_http_proxy_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
951 клиенту, то исправить это уже невозможно.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
952 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
953
942
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
954 <para>
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
955 Директива также определяет, что считается неудачной попыткой работы с
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
956 <link doc="ngx_http_upstream_module.xml" id="server">сервером</link>.
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
957 Случаи <literal>error</literal>, <literal>timeout</literal> и
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
958 <literal>invalid_header</literal>
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
959 всегда считаются неудачными попытками, даже если они не указаны в директиве.
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
960 Случаи <literal>http_500</literal>, <literal>http_502</literal>,
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
961 <literal>http_503</literal> и <literal>http_504</literal>
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
962 считаются неудачными попытками, только если они указаны в директиве.
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
963 Случаи <literal>http_403</literal> и <literal>http_404</literal>
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
964 никогда не считаются неудачными попытками.
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
965 </para>
ba3d6ade3513 Elaborate on upstream server failures.
Ruslan Ermilov <ru@nginx.com>
parents: 917
diff changeset
966
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
967 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
968
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
969
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
970 <directive name="proxy_no_cache">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
971 <syntax><value>строка</value> ...</syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
972 <default/>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
973 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
974 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
975 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
976
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
977 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
978 Задаёт условия, при которых ответ не будет сохраняться в кэш.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
979 Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
980 то ответ не будет сохранён:
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
981 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
982 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
983 proxy_no_cache $http_pragma $http_authorization;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
984 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
985 Можно использовать совместно с директивой <link id="proxy_cache_bypass"/>.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
986 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
987
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
988 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
989
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
990
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
991 <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
992 <syntax><value>URL</value></syntax>
99
1d315ef37215 The case <default/> is now language-agnostic.
Ruslan Ermilov <ru@nginx.com>
parents: 98
diff changeset
993 <default/>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
994 <context>location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
995 <context>if в location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
996 <context>limit_except</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
997
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
998 <para>
791
15f2bab0740d Fixed a typo in the "proxy_pass" directive description.
Vladimir Homutov <vl@nginx.com>
parents: 790
diff changeset
999 Задаёт протокол и адрес проксируемого сервера, а также необязательный URI,
535
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1000 на который должен отображаться location.
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1001 В качестве протокола можно указать
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1002 “<literal>http</literal>” или “<literal>https</literal>”.
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1003 Адрес может быть указан в виде доменного имени или IP-адреса,
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1004 и необязательного порта:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1005 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1006 proxy_pass http://localhost:8000/uri/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1007 </example>
535
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1008 или в виде пути UNIX-сокета, который указывается после слова
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1009 “<literal>unix</literal>” и заключается в двоеточия:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1010 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1011 proxy_pass http://unix:/tmp/backend.socket:/uri/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1012 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1013 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1014
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1015 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1016 Если доменному имени соответствует несколько адресов, то все они будут
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1017 использоваться по очереди (round-robin).
535
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1018 Кроме того, в качестве адреса можно указать
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1019 <link doc="ngx_http_upstream_module.xml">группу серверов</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1020 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1021
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1022 <para>
535
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1023 URI запроса передаётся на сервер так:
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1024 <list type="bullet" compact="no">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1025
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1026 <listitem>
959
fbb4cc6f8c3d Text review of ngx_http_proxy_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
1027 Если директива <literal>proxy_pass</literal> указана с URI,
535
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1028 то при передаче запроса серверу часть
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1029 <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
1030 URI запроса, соответствующая location, заменяется на URI,
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1031 указанный в директиве:
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1032 <example>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1033 location /name/ {
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1034 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
1035 }
535
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1036 </example>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1037 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1038
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1039 <listitem>
959
fbb4cc6f8c3d Text review of ngx_http_proxy_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
1040 Если директива <literal>proxy_pass</literal> указана без URI,
535
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1041 то при обработке первоначального запроса на сервер передаётся
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1042 URI запроса в том же виде, в каком его прислал клиент,
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1043 а при обработке изменённого URI&mdash;
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1044 нормализованный URI запроса целиком:
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1045 <example>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1046 location /some/path/ {
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1047 proxy_pass http://127.0.0.1;
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1048 }
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1049 </example>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1050 <note>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1051 До версии 1.1.12,
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1052 если <literal>proxy_pass</literal> указана без URI,
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1053 в ряде случаев при изменении URI на сервер мог передаваться
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1054 URI первоначального запроса вместо изменённого URI.
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1055 </note>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1056 </listitem>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1057 </list>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1058 </para>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1059
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1060 <para>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1061 В ряде случаев часть URI запроса, подлежащую замене, выделить невозможно:
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1062 <list type="bullet" compact="no">
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1063
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1064 <listitem>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1065 Если location задан регулярным выражением.
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1066 <para>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1067 В этом случае директиву следует указывать без URI.
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1068 </para>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1069 </listitem>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1070
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1071 <listitem>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1072 Если внутри проксируемого location с помощью директивы
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1073 <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
1074 URI, и именно с этой конфигурацией будет обрабатываться запрос
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1075 (<literal>break</literal>):
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1076 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1077 location /name/ {
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1078 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
1079 proxy_pass http://127.0.0.1;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1080 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1081 </example>
535
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1082 <para>
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1083 В этом случае URI, указанный в директиве, игнорируется, и на сервер
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1084 передаётся изменённый URI запроса целиком.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1085 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1086 </listitem>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1087 </list>
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 Имя сервера, его порт и передаваемый URI можно также полностью задать
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1092 с помощью переменных:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1093 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1094 proxy_pass http://$host$uri;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1095 </example>
535
f8652d663b62 Revised description of "proxy_pass".
Ruslan Ermilov <ru@nginx.com>
parents: 508
diff changeset
1096 или даже так:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1097 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1098 proxy_pass $request;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1099 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1100 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1101
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1102 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1103 В этом случае имя сервера ищется среди описанных
135
edf8c90f8085 Renamed ngx_http_upstream to ngx_http_upstream_module.
Ruslan Ermilov <ru@nginx.com>
parents: 110
diff changeset
1104 <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
1105 и если не найдено, то определяется с помощью
625
af3f38e349eb Removed terminal whitespace and fixed apostrophes used.
Ruslan Ermilov <ru@nginx.com>
parents: 589
diff changeset
1106 <link doc="ngx_http_core_module.xml" id="resolver"/>’а.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1107 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1108
849
0ed4c093c026 WebSocket proxying howto.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
1109 <para>
0ed4c093c026 WebSocket proxying howto.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
1110 Проксирование <link doc="websocket.xml">WebSocket</link> требует особой
0ed4c093c026 WebSocket proxying howto.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
1111 настройки и поддерживается начиная с версии 1.3.13.
0ed4c093c026 WebSocket proxying howto.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
1112 </para>
0ed4c093c026 WebSocket proxying howto.
Homutov Vladimir <vl@nginx.com>
parents: 815
diff changeset
1113
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1114 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1115
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1116
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1117 <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
1118 <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
1119 <default/>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1120 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1121 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1122 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1123
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1124 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1125 Разрешает передавать от проксируемого сервера клиенту
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1126 <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
1127 </para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1128
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1129 </directive>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1130
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1131
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1132 <directive name="proxy_read_timeout">
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1133 <syntax><value>время</value></syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1134 <default>60s</default>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1135 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1136 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1137 <context>location</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1138
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1139 <para>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1140 Задаёт таймаут при чтении ответа проксированного сервера.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1141 Таймаут устанавливается не на всю передачу ответа,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1142 а только между двумя операциями чтения.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1143 Если по истечении этого времени проксируемый сервер ничего не передаст,
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
1144 соединение закрывается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1145 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1146
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1147 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1148
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1149
789
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1150 <directive name="proxy_pass_request_body">
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1151 <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
1152 <default>on</default>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1153 <context>http</context>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1154 <context>server</context>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1155 <context>location</context>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1156
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1157 <para>
959
fbb4cc6f8c3d Text review of ngx_http_proxy_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
1158 Позволяет запретить передачу исходного тела запроса
789
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1159 на проксируемый сервер.
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1160 <example>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1161 location /x-accel-redirect-here/ {
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1162 proxy_method GET;
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1163 proxy_pass_request_body off;
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1164 proxy_set_header Content-Length "";
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1165
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1166 proxy_pass ...
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1167 }
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1168 </example>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1169 См. также директивы <link id="proxy_set_header"/> и
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1170 <link id="proxy_pass_request_headers"/>.
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1171 </para>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1172
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1173 </directive>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1174
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1175
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1176 <directive name="proxy_pass_request_headers">
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1177 <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
1178 <default>on</default>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1179 <context>http</context>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1180 <context>server</context>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1181 <context>location</context>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1182
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1183 <para>
959
fbb4cc6f8c3d Text review of ngx_http_proxy_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
1184 Позволяет запретить передачу полей заголовка исходного запроса на
789
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1185 проксируемый сервер.
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1186 <example>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1187 location /x-accel-redirect-here/ {
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1188 proxy_method GET;
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1189 proxy_pass_request_headers off;
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1190 proxy_pass_request_body off;
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1191
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1192 proxy_pass ...
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1193 }
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1194 </example>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1195 См. также директивы <link id="proxy_set_header"/> и
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1196 <link id="proxy_pass_request_body"/>.
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1197 </para>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1198
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1199 </directive>
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1200
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1201
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1202 <directive name="proxy_redirect">
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1203 <syntax><literal>default</literal></syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1204 <syntax><literal>off</literal></syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1205 <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
1206 <default>default</default>
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1207 <context>http</context>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1208 <context>server</context>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1209 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1210
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1211 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1212 Задаёт текст, который нужно изменить в полях заголовка
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1213 <header>Location</header> и <header>Refresh</header> в ответе
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1214 проксируемого сервера.
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1215 Предположим, проксируемый сервер вернул поле заголовка
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1216 “<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
1217 Директива
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1218 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1219 proxy_redirect http://localhost:8000/two/ http://frontend/one/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1220 </example>
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1221 перепишет эту строку в виде
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1222 “<literal>Location: http://frontend/one/some/uri/</literal>”.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1223 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1224
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1225 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1226 В заменяемой строке можно не указывать имя сервера:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1227 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1228 proxy_redirect http://localhost:8000/two/ /;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1229 </example>
959
fbb4cc6f8c3d Text review of ngx_http_proxy_module.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 942
diff changeset
1230 тогда будут подставлены основное имя сервера и порт, если он отличен от 80.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1231 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1232
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1233 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
1234 Стандартная замена, задаваемая параметром <literal>default</literal>,
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1235 использует параметры директив
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1236 <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
1237 <link id="proxy_pass"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1238 Поэтому две нижеприведённые конфигурации одинаковы:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1239 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1240 location /one/ {
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1241 proxy_pass http://upstream:port/two/;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1242 proxy_redirect default;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1243 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1244
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1245 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1246 location /one/ {
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1247 proxy_pass http://upstream:port/two/;
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1248 proxy_redirect http://upstream:port/two/ /one/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1249 </example>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
1250 Параметр <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
1251 используются переменные.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1252 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1253
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1254 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
1255 В строке <value>замена</value> можно использовать переменные:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1256 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1257 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
1258 </example>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1259 </para>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1260
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1261 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
1262 В строке <value>перенаправление</value> тоже можно использовать (1.1.11)
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
1263 переменные:
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1264 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1265 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
1266 </example>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1267 </para>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1268
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1269 <para>
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1270 Директиву также можно задать (1.1.11) при помощи регулярных выражений.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
1271 При этом <value>перенаправление</value> должно начинаться либо с символа
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
1272 “<literal>~</literal>”, если при сравнении следует учитывать регистр символов,
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
1273 либо с символов “<literal>~*</literal>”, если регистр символов учитывать
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
1274 не нужно.
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1275 Регулярное выражение может содержать именованные и позиционные выделения,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
1276 а <value>замена</value> ссылаться на них:
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1277 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1278 proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2;
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1279 proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1280 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1281 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1282
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1283 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
1284 Директив <literal>proxy_redirect</literal> может быть несколько:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1285 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1286 proxy_redirect default;
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1287 proxy_redirect http://localhost:8000/ /;
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1288 proxy_redirect http://www.example.com/ /;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1289 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1290 </para>
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 <para>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
1293 Параметр <literal>off</literal> запрещает все директивы
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
1294 <literal>proxy_redirect</literal>
238
e33fc8541217 - "proxy_redirect" supports variables in the first parameter,
Ruslan Ermilov <ru@nginx.com>
parents: 222
diff changeset
1295 на данном уровне:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1296 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1297 proxy_redirect off;
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1298 proxy_redirect default;
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1299 proxy_redirect http://localhost:8000/ /;
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1300 proxy_redirect http://www.example.com/ /;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1301 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1302 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1303
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1304 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1305 С помощью этой директивы можно также добавлять имя хоста к относительным
256
c78b2d6fe261 Use another term for "redirect".
Ruslan Ermilov <ru@nginx.com>
parents: 238
diff changeset
1306 перенаправлениям, выдаваемым проксируемым сервером:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1307 <example>
351
a4fa80755eab Consistently strip initial offset in examples.
Ruslan Ermilov <ru@nginx.com>
parents: 316
diff changeset
1308 proxy_redirect / /;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1309 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1310 </para>
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>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1313
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1314
773
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1315 <directive name="proxy_send_lowat">
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1316 <syntax><value>размер</value></syntax>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1317 <default>0</default>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1318 <context>http</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1319 <context>server</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1320 <context>location</context>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1321
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1322 <para>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 959
diff changeset
1323 При установке директивы в ненулевое значение nginx будет пытаться минимизировать
773
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1324 число операций отправки на исходящих соединениях с проксируемым сервером либо
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1325 при помощи флага <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
1326 <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
1327 либо при помощи параметра сокета <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
1328 с указанным <value>размером</value>.
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1329 </para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1330
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1331 <para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1332 Эта директива игнорируется на Linux, Solaris и Windows.
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1333 </para>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1334
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1335 </directive>
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1336
24b1b0101250 Documented "send_lowat" directive in fastcgi and proxy modules.
Vladimir Homutov <vl@nginx.com>
parents: 772
diff changeset
1337
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1338 <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
1339 <syntax><value>время</value></syntax>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
1340 <default>60s</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1341 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1342 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1343 <context>location</context>
76
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 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1346 Задаёт таймаут при передаче запроса проксированному серверу.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1347 Таймаут устанавливается не на всю передачу запроса,
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 Если по истечении этого времени проксируемый сервер не примет новых данных,
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
1350 соединение закрывается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1351 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1352
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1353 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1354
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1355
787
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1356 <directive name="proxy_set_body">
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1357 <syntax><value>значение</value></syntax>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1358 <default/>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1359 <context>http</context>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1360 <context>server</context>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1361 <context>location</context>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1362
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1363 <para>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1364 Позволяет переопределить тело запроса, передаваемое на проксируемый сервер.
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1365 В качестве значения можно использовать текст, переменные и их комбинации.
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1366 </para>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1367
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1368 </directive>
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1369
180a64c709d8 Documented "proxy_set_body" and "proxy_method" directives.
Vladimir Homutov <vl@nginx.com>
parents: 773
diff changeset
1370
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1371 <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
1372 <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
1373 <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
1374 <default>Connection close</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1375 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1376 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1377 <context>location</context>
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 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1380 Позволяет переопределять или добавлять поля заголовка запроса,
789
1063836dacea Documented "proxy_pass_request_body/headers" directives.
Vladimir Homutov <vl@nginx.com>
parents: 787
diff changeset
1381 <link id="proxy_pass_request_headers">передаваемые</link> проксируемому серверу.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1382 В качестве значения можно использовать текст, переменные и их комбинации.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1383 Директивы наследуются с предыдущего уровня при условии, что на данном
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1384 уровне не описаны свои директивы <literal>proxy_set_header</literal>.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1385 По умолчанию переопределяются только два поля:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1386 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1387 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
1388 proxy_set_header Connection close;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1389 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1390 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1391
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1392 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1393 Неизменённое поле заголовка запроса <header>Host</header> можно передать так:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1394 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1395 proxy_set_header Host $http_host;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1396 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1397 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1398
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1399 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1400 Однако, если это поле отсутствует в заголовке запроса клиента, то ничего
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
1401 передаваться не будет.
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
1402 В этом случае лучше воспользоваться переменной <var>$host</var>&mdash;её
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
1403 значение равно имени сервера в поле <header>Host</header>
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_set_header Host $host;
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>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1411 Кроме того, можно передать имя сервера вместе с портом проксируемого сервера:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1412 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1413 proxy_set_header Host $host:$proxy_port;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1414 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1415 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1416
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1417 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1418 Если значение поля заголовка — пустая строка, то поле вообще
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1419 не будет передаваться проксируемому серверу:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1420 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1421 proxy_set_header Accept-Encoding "";
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1422 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1423 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1424
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1425 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1426
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1427
993
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1428 <directive name="proxy_ssl_ciphers">
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1429 <syntax><value>ciphers</value></syntax>
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1430 <default>DEFAULT</default>
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1431 <context>http</context>
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1432 <context>server</context>
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1433 <context>location</context>
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1434 <appeared-in>1.5.6</appeared-in>
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1435
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1436 <para>
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1437 Описывает разрешённые шифры для запросов к проксируемому HTTPS-серверу.
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1438 Шифры задаются в формате, поддерживаемом библиотекой OpenSSL.
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1439 </para>
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1440
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1441 <para>
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1442 Полный список можно посмотреть с помощью команды
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1443 “<command>openssl ciphers</command>”.
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1444 </para>
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1445
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1446 </directive>
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1447
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1448
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1449 <directive name="proxy_ssl_session_reuse">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
1450 <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
1451 <default>on</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1452 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1453 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1454 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1455
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1456 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1457 Определяет, использовать ли повторно SSL-сессии при
364
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
1458 работе с проксированным сервером.
bb51d3e17dd0 Style fixed.
Ruslan Ermilov <ru@nginx.com>
parents: 351
diff changeset
1459 Если в логах появляются ошибки
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1460 “<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
1461 то можно попробовать выключить
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1462 повторное использование сессий.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1463 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1464
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1465 </directive>
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
985
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1468 <directive name="proxy_ssl_protocols">
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1469 <syntax>
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1470 [<literal>SSLv2</literal>]
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1471 [<literal>SSLv3</literal>]
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1472 [<literal>TLSv1</literal>]
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1473 [<literal>TLSv1.1</literal>]
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1474 [<literal>TLSv1.2</literal>]</syntax>
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1475 <default>SSLv3 TLSv1 TLSv1.1 TLSv1.2</default>
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1476 <context>http</context>
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1477 <context>server</context>
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1478 <context>location</context>
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1479 <appeared-in>1.5.6</appeared-in>
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1480
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1481 <para>
993
a59aba3d4b67 Proxy: documented the "proxy_ssl_ciphers" directive.
Andrei Belov <defan@nginx.com>
parents: 992
diff changeset
1482 Разрешает указанные протоколы для запросов к проксируемому HTTPS-серверу.
985
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1483 </para>
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1484
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1485 </directive>
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1486
e4704604ed29 Proxy: documented the "proxy_ssl_protocols" directive.
Andrei Belov <defan@nginx.com>
parents: 966
diff changeset
1487
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1488 <directive name="proxy_store">
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1489 <syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1490 <literal>on</literal> |
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1491 <literal>off</literal> |
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1492 <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
1493 <default>off</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1494 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1495 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1496 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1497
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1498 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1499 Разрешает сохранение на диск файлов.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1500 Параметр <literal>on</literal> сохраняет файлы в соответствии с путями,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1501 указанными в директивах
106
56457a474903 If text of the link is not provided, the @id is used.
Ruslan Ermilov <ru@nginx.com>
parents: 102
diff changeset
1502 <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
1503 <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
1504 Параметр <literal>off</literal> запрещает сохранение файлов.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1505 Кроме того, имя файла можно задать явно с помощью строки с переменными:
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1506 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1507 proxy_store /data/www$original_uri;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1508 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1509 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1510
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1511 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1512 Время изменения файлов выставляется согласно полученному полю
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1513 <header>Last-Modified</header> в заголовке ответа.
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
1514 Ответ сначала записывается во временный файл, а потом этот файл
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
1515 переименовывается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1516 Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 959
diff changeset
1517 могут располагаться на разных файловых системах.
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 959
diff changeset
1518 Однако нужно учитывать,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1519 что в этом случае вместо дешёвой операции переименовывания в пределах
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1520 одной файловой системы файл копируется с одной файловой системы на другую.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1521 Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1522 системе, что и каталог с временными файлами, задаваемый директивой
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1523 <link id="proxy_temp_path"/> для данного location.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1524 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1525
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1526 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1527 Директиву можно использовать для создания локальных копий статических
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1528 неизменяемых файлов, например, так:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1529 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1530 location /images/ {
1005
2275611970dd Removed open_file_cache_errors from proxy_store examples.
Maxim Dounin <mdounin@mdounin.ru>
parents: 993
diff changeset
1531 root /data/www;
2275611970dd Removed open_file_cache_errors from proxy_store examples.
Maxim Dounin <mdounin@mdounin.ru>
parents: 993
diff changeset
1532 error_page 404 = /fetch$uri;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1533 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1534
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1535 location /fetch/ {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1536 internal;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1537
1005
2275611970dd Removed open_file_cache_errors from proxy_store examples.
Maxim Dounin <mdounin@mdounin.ru>
parents: 993
diff changeset
1538 proxy_pass http://backend/;
2275611970dd Removed open_file_cache_errors from proxy_store examples.
Maxim Dounin <mdounin@mdounin.ru>
parents: 993
diff changeset
1539 proxy_store on;
2275611970dd Removed open_file_cache_errors from proxy_store examples.
Maxim Dounin <mdounin@mdounin.ru>
parents: 993
diff changeset
1540 proxy_store_access user:rw group:rw all:r;
2275611970dd Removed open_file_cache_errors from proxy_store examples.
Maxim Dounin <mdounin@mdounin.ru>
parents: 993
diff changeset
1541 proxy_temp_path /data/temp;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1542
1005
2275611970dd Removed open_file_cache_errors from proxy_store examples.
Maxim Dounin <mdounin@mdounin.ru>
parents: 993
diff changeset
1543 alias /data/www/;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1544 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1545 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1546 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1547
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1548 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1549 или так:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1550 <example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1551 location /images/ {
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1552 root /data/www;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1553 error_page 404 = @fetch;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1554 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1555
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1556 location @fetch {
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1557 internal;
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1558
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1559 proxy_pass http://backend;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1560 proxy_store on;
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1561 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
1562 proxy_temp_path /data/temp;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1563
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1564 root /data/www;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1565 }
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1566 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1567 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1568
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1569 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1570
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1571
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1572 <directive name="proxy_store_access">
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
1573 <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
1574 <default>user:rw</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1575 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1576 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1577 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1578
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1579 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1580 Задаёт права доступа для создаваемых файлов и каталогов, например,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1581 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1582 proxy_store_access user:rw group:rw all:r;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1583 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1584 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1585
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1586 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1587 Если заданы какие-либо права для <literal>group</literal> или
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1588 <literal>all</literal>, то права для <literal>user</literal>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1589 указывать необязательно:
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1590 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1591 proxy_store_access group:rw all:r;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1592 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1593 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1594
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1595 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1596
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1597
405
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1598 <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
1599 <syntax><value>размер</value></syntax>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1600 <default>8k|16k</default>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1601 <context>http</context>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1602 <context>server</context>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1603 <context>location</context>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1604
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1605 <para>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1606 Ограничивает <value>размер</value> данных, сбрасываемых во временный файл
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1607 за один раз, при включённой буферизации ответов проксируемого сервера
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1608 во временные файлы.
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1609 По умолчанию <value>размер</value> ограничен двумя буферами, заданными
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1610 директивами <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
1611 Максимальный размер временного файла задаётся директивой
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1612 <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
1613 </para>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1614
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1615 </directive>
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1616
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1617
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1618 <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
1619 <syntax>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1620 <value>путь</value>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1621 [<value>уровень1</value>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1622 [<value>уровень2</value>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1623 [<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
1624 <default>proxy_temp</default>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1625 <context>http</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1626 <context>server</context>
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1627 <context>location</context>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1628
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1629 <para>
405
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1630 Задаёт имя каталога для хранения временных файлов с данными,
781b23ba3b0a Documented the following directives: proxy_busy_buffers_size,
Ruslan Ermilov <ru@nginx.com>
parents: 364
diff changeset
1631 полученными от проксируемых серверов.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1632 В каталоге может использоваться иерархия подкаталогов до трёх уровней.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1633 Например, при такой конфигурации
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1634 <example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1635 proxy_temp_path /spool/nginx/proxy_temp 1 2;
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1636 </example>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1637 временный файл будет следующего вида:
98
a10bc0cb0a6a Whitespace cleanup.
Ruslan Ermilov <ru@nginx.com>
parents: 97
diff changeset
1638 <example>
279
fa1213cffc34 Revision.
Ruslan Ermilov <ru@nginx.com>
parents: 273
diff changeset
1639 /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
1640 </example>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1641 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1642
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1643 </directive>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1644
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1645 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1646
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1647
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1648 <section id="variables" name="Встроенные переменные">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1649
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1650 <para>
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1651 В модуле <literal>ngx_http_proxy_module</literal> есть встроенные переменные,
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1652 которые можно использовать для формирования заголовков с помощью директивы
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1653 <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
1654 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1655
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1656 <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
1657 <tag-desc>имя проксируемого хоста и порт;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1658
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1659 <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
1660 <tag-desc>порт проксируемого хоста;</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1661
273
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1662 <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
1663 <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
1664 и добавленная к нему через запятую переменная <var>$remote_addr</var>.
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1665 Если же поля <header>X-Forwarded-For</header> в заголовке запроса клиента нет,
44ab4026d9f5 Fixed markup and spelling, sorted directives, added missing links,
Ruslan Ermilov <ru@nginx.com>
parents: 271
diff changeset
1666 то переменная <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
1667 равна переменной <var>$remote_addr</var>.</tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1668 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1669 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1670
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1671 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1672
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
1673 </module>