Mercurial > hg > nginx-site

annotate xml/ru/docs/http/ngx_http_proxy_module.xml @ 274:457c54242cfa

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