Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 102:c76a257f3fd4

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
The directive name is now automatically printed in <default> and <syntax>. Specifying <default> is made non-optional. Visible changes: - "types" and "proxy_set_header" get proper defaults (not yet displayed nicely); - "fastcgi_hide_header", "fastcgi_ignore_headers", "fastcgi_pass_header", "proxy_hide_header", "proxy_ignore_headers", and "proxy_pass_header" now have their (empty) defaults documented; - mentions of "fastcgi_redirect_errors" and "proxy_redirect_errors" which are long unsupported were removed.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 19 Oct 2011 05:15:24 +0000
parents 1d315ef37215
children 56457a474903
comparison
equal deleted inserted replaced
101:b8fd014ec712 102:c76a257f3fd4
31 31
32 32
33 <section name="Директивы" id="directives"> 33 <section name="Директивы" id="directives">
34 34
35 <directive name="proxy_buffer_size"> 35 <directive name="proxy_buffer_size">
36 <syntax>proxy_buffer_size <value>размер</value></syntax> 36 <syntax><value>размер</value></syntax>
37 <default>proxy_buffer_size 4k/8k</default> 37 <default>4k/8k</default>
38 <context>http, server, location</context> 38 <context>http, server, location</context>
39 39
40 <para> 40 <para>
41 Директива задаёт размер буфера, в который будет читаться 41 Директива задаёт размер буфера, в который будет читаться
42 первая часть ответа, получаемого от проксируемого сервера. 42 первая часть ответа, получаемого от проксируемого сервера.
47 47
48 </directive> 48 </directive>
49 49
50 50
51 <directive name="proxy_buffering"> 51 <directive name="proxy_buffering">
52 <syntax>proxy_buffering <value>on|off</value></syntax> 52 <syntax><value>on|off</value></syntax>
53 <default>proxy_buffering on</default> 53 <default>on</default>
54 <context>http, server, location</context> 54 <context>http, server, location</context>
55 55
56 <para> 56 <para>
57 Директива разрешает использовать буферизацию ответа проксируемого сервера. 57 Директива разрешает использовать буферизацию ответа проксируемого сервера.
58 Если буферизация включена, то nginx принимает ответ проксируемого сервера 58 Если буферизация включена, то nginx принимает ответ проксируемого сервера
70 70
71 </directive> 71 </directive>
72 72
73 73
74 <directive name="proxy_buffers"> 74 <directive name="proxy_buffers">
75 <syntax>proxy_buffers <value>число размер</value></syntax> 75 <syntax><value>число размер</value></syntax>
76 <default>proxy_buffers 8 4k/8k</default> 76 <default>8 4k/8k</default>
77 <context>http, server, location</context> 77 <context>http, server, location</context>
78 78
79 <para> 79 <para>
80 Директива задаёт число и размер буферов для одного соединения, 80 Директива задаёт число и размер буферов для одного соединения,
81 в которые будет читаться ответ, получаемый от проксируемого сервера. 81 в которые будет читаться ответ, получаемый от проксируемого сервера.
85 85
86 </directive> 86 </directive>
87 87
88 88
89 <directive name="proxy_cache"> 89 <directive name="proxy_cache">
90 <syntax>proxy_cache <value>[зона|off]</value></syntax> 90 <syntax><value>[зона|off]</value></syntax>
91 <default>off</default> 91 <default>off</default>
92 <context>http, server, location</context> 92 <context>http, server, location</context>
93 93
94 <para> 94 <para>
95 Директива задаёт зону для кэширования. 95 Директива задаёт зону для кэширования.
100 100
101 </directive> 101 </directive>
102 102
103 103
104 <directive name="proxy_cache_bypass"> 104 <directive name="proxy_cache_bypass">
105 <syntax>proxy_cache_bypass <value>строка [...]</value></syntax> 105 <syntax><value>строка [...]</value></syntax>
106 <default/> 106 <default/>
107 <context>http, server, location</context> 107 <context>http, server, location</context>
108 108
109 <para> 109 <para>
110 Директива задаёт условия, при которых ответ не будет браться из кэша. 110 Директива задаёт условия, при которых ответ не будет браться из кэша.
119 119
120 </directive> 120 </directive>
121 121
122 122
123 <directive name="proxy_cache_key"> 123 <directive name="proxy_cache_key">
124 <syntax>proxy_cache_key <value>строка</value></syntax> 124 <syntax><value>строка</value></syntax>
125 <default>$scheme$proxy_host$request_uri</default> 125 <default>$scheme$proxy_host$request_uri</default>
126 <context>http, server, location</context> 126 <context>http, server, location</context>
127 127
128 <para> 128 <para>
129 Директива задаёт ключ для кэширования, например, 129 Директива задаёт ключ для кэширования, например,
138 138
139 </directive> 139 </directive>
140 140
141 141
142 <directive name="proxy_cache_path"> 142 <directive name="proxy_cache_path">
143 <syntax>proxy_cache_path <value>путь [levels=уровни] 143 <syntax><value>путь [levels=уровни]
144 keys_zone=название:размер [inactive=время] [max_size=размер]</value></syntax> 144 keys_zone=название:размер [inactive=время] [max_size=размер]</value></syntax>
145 <default/> 145 <default/>
146 <context>http</context> 146 <context>http</context>
147 147
148 <para> 148 <para>
186 186
187 </directive> 187 </directive>
188 188
189 189
190 <directive name="proxy_cache_min_uses"> 190 <directive name="proxy_cache_min_uses">
191 <syntax>proxy_cache_min_uses <value>число</value></syntax> 191 <syntax><value>число</value></syntax>
192 <default>proxy_cache_min_uses 1</default> 192 <default>1</default>
193 <context>http, server, location</context> 193 <context>http, server, location</context>
194 194
195 <para> 195 <para>
196 Директива задаёт число запросов, после которого ответ будет 196 Директива задаёт число запросов, после которого ответ будет
197 закэширован. 197 закэширован.
199 199
200 </directive> 200 </directive>
201 201
202 202
203 <directive name="proxy_cache_valid"> 203 <directive name="proxy_cache_valid">
204 <syntax>proxy_cache_valid <value>ответ [ответ ...] время</value> 204 <syntax><value>ответ [ответ ...] время</value>
205 </syntax> 205 </syntax>
206 <default/> 206 <default/>
207 <context>http, server, location</context> 207 <context>http, server, location</context>
208 208
209 <para> 209 <para>
236 236
237 </directive> 237 </directive>
238 238
239 239
240 <directive name="proxy_cache_use_stale"> 240 <directive name="proxy_cache_use_stale">
241 <syntax>proxy_cache_use_stale <value>[error | timeout | invalid_header 241 <syntax><value>[error | timeout | invalid_header
242 | updating | http_500 | http_502 | http_503 | http_504 | http_404 | off] 242 | updating | http_500 | http_502 | http_503 | http_504 | http_404 | off]
243 [...]</value></syntax> 243 [...]</value></syntax>
244 <default>proxy_cache_use_stale off</default> 244 <default>off</default>
245 <context>http, server, location</context> 245 <context>http, server, location</context>
246 246
247 <para> 247 <para>
248 Директива определяет, в каких случаях можно использовать 248 Директива определяет, в каких случаях можно использовать
249 устаревший закэшированный ответ, если при работе с проксированным 249 устаревший закэшированный ответ, если при работе с проксированным
255 255
256 </directive> 256 </directive>
257 257
258 258
259 <directive name="proxy_connect_timeout"> 259 <directive name="proxy_connect_timeout">
260 <syntax>proxy_connect_timeout <value>время</value></syntax> 260 <syntax><value>время</value></syntax>
261 <default>proxy_connect_timeout 60</default> 261 <default>60</default>
262 <context>http, server, location</context> 262 <context>http, server, location</context>
263 263
264 <para> 264 <para>
265 Директива задаёт таймаут для соединения с проксированным сервером. 265 Директива задаёт таймаут для соединения с проксированным сервером.
266 Необходимо иметь в виду, что этот таймаут не может быть больше 75 секунд. 266 Необходимо иметь в виду, что этот таймаут не может быть больше 75 секунд.
268 268
269 </directive> 269 </directive>
270 270
271 271
272 <directive name="proxy_hide_header"> 272 <directive name="proxy_hide_header">
273 <syntax>proxy_hide_header <value>имя</value></syntax> 273 <syntax><value>имя</value></syntax>
274 <default/>
274 <context>http, server, location</context> 275 <context>http, server, location</context>
275 276
276 <para> 277 <para>
277 nginx не передаёт клиенту строки заголовка "Date", "Server", "X-Pad" и 278 nginx не передаёт клиенту строки заголовка "Date", "Server", "X-Pad" и
278 "X-Accel-..." из ответа проксированного сервера. 279 "X-Accel-..." из ответа проксированного сервера.
283 284
284 </directive> 285 </directive>
285 286
286 287
287 <directive name="proxy_ignore_client_abort"> 288 <directive name="proxy_ignore_client_abort">
288 <syntax>proxy_ignore_client_abort <value>[on|off]</value></syntax> 289 <syntax><value>[on|off]</value></syntax>
289 <default>proxy_ignore_client_abort off</default> 290 <default>off</default>
290 <context>http, server, location</context> 291 <context>http, server, location</context>
291 292
292 <para> 293 <para>
293 Директива определяет, закрывать ли соединение с проксированным сервером 294 Директива определяет, закрывать ли соединение с проксированным сервером
294 в случае, если клиент закрыл соединение, не дождавшись ответа. 295 в случае, если клиент закрыл соединение, не дождавшись ответа.
296 297
297 </directive> 298 </directive>
298 299
299 300
300 <directive name="proxy_ignore_headers"> 301 <directive name="proxy_ignore_headers">
301 <syntax>proxy_ignore_headers <value>имя [имя ...]</value></syntax> 302 <syntax><value>имя [имя ...]</value></syntax>
303 <default/>
302 <context>http, server, location</context> 304 <context>http, server, location</context>
303 305
304 <para> 306 <para>
305 Директива proxy_ignore_headers запрещает обработку некоторых 307 Директива proxy_ignore_headers запрещает обработку некоторых
306 строк заголовка из ответа проксированного сервера. 308 строк заголовка из ответа проксированного сервера.
311 313
312 </directive> 314 </directive>
313 315
314 316
315 <directive name="proxy_intercept_errors"> 317 <directive name="proxy_intercept_errors">
316 <syntax>proxy_intercept_errors <value>[on|off]</value></syntax> 318 <syntax><value>[on|off]</value></syntax>
317 <default>proxy_intercept_errors off</default> 319 <default>off</default>
318 <context>http, server, location</context> 320 <context>http, server, location</context>
319 321
320 <para> 322 <para>
321 Директива определяет, передавать ли клиенту проксированные ответы с кодом 323 Директива определяет, передавать ли клиенту проксированные ответы с кодом
322 больше или равные 400 или же перенаправлять их на обработку nginx'у с помощью 324 больше или равные 400 или же перенаправлять их на обработку nginx'у с помощью
325 327
326 </directive> 328 </directive>
327 329
328 330
329 <directive name="proxy_next_upstream"> 331 <directive name="proxy_next_upstream">
330 <syntax>proxy_next_upstream <value>[error | timeout | invalid_header 332 <syntax><value>[error | timeout | invalid_header
331 | http_500 | http_502 | http_503 | http_504 | http_404 | off] 333 | http_500 | http_502 | http_503 | http_504 | http_404 | off]
332 [...]</value></syntax> 334 [...]</value></syntax>
333 <default>proxy_next_upstream error timeout</default> 335 <default>error timeout</default>
334 <context>http, server, location</context> 336 <context>http, server, location</context>
335 337
336 <para> 338 <para>
337 Директива определяет, в каких случаях запрос будет передан следующему серверу: 339 Директива определяет, в каких случаях запрос будет передан следующему серверу:
338 <list type="bullet"> 340 <list type="bullet">
387 389
388 </directive> 390 </directive>
389 391
390 392
391 <directive name="proxy_no_cache"> 393 <directive name="proxy_no_cache">
392 <syntax>proxy_no_cache <value>строка [...]</value></syntax> 394 <syntax><value>строка [...]</value></syntax>
393 <default/> 395 <default/>
394 <context>http, server, location</context> 396 <context>http, server, location</context>
395 397
396 <para> 398 <para>
397 Директива задаёт условия, при которых ответ не будет сохраняться в кэш. 399 Директива задаёт условия, при которых ответ не будет сохраняться в кэш.
406 408
407 </directive> 409 </directive>
408 410
409 411
410 <directive name="proxy_pass"> 412 <directive name="proxy_pass">
411 <syntax>proxy_pass <value>URL</value></syntax> 413 <syntax><value>URL</value></syntax>
412 <default/> 414 <default/>
413 <context>location, if в location, limit_except</context> 415 <context>location, if в location, limit_except</context>
414 416
415 <para> 417 <para>
416 Директива задаёт адрес проксируемоего сервера и URI, на который 418 Директива задаёт адрес проксируемоего сервера и URI, на который
511 513
512 </directive> 514 </directive>
513 515
514 516
515 <directive name="proxy_pass_header"> 517 <directive name="proxy_pass_header">
516 <syntax>proxy_pass_header <value>имя</value></syntax> 518 <syntax><value>имя</value></syntax>
519 <default/>
517 <context>http, server, location</context> 520 <context>http, server, location</context>
518 521
519 <para> 522 <para>
520 Директива разрешает передавать от проксируемого сервера клиенту 523 Директива разрешает передавать от проксируемого сервера клиенту
521 запрещённые для передачи строки. 524 запрещённые для передачи строки.
523 526
524 </directive> 527 </directive>
525 528
526 529
527 <directive name="proxy_redirect"> 530 <directive name="proxy_redirect">
528 <syntax>proxy_redirect <value>[default|off|редирект замена]</value> 531 <syntax><value>[default|off|редирект замена]</value>
529 </syntax> 532 </syntax>
530 <default>proxy_redirect default</default> 533 <default>default</default>
531 <context>http, server, location</context> 534 <context>http, server, location</context>
532 535
533 <para> 536 <para>
534 Директива задаёт текст, который нужно изменить в строках заголовка "Location" 537 Директива задаёт текст, который нужно изменить в строках заголовка "Location"
535 и "Refresh" в ответе проксируемого сервера. Предположим, проксируемый сервер 538 и "Refresh" в ответе проксируемого сервера. Предположим, проксируемый сервер
601 604
602 </directive> 605 </directive>
603 606
604 607
605 <directive name="proxy_read_timeout"> 608 <directive name="proxy_read_timeout">
606 <syntax>proxy_read_timeout <value>время</value></syntax> 609 <syntax><value>время</value></syntax>
607 <default>proxy_read_timeout 60</default> 610 <default>60</default>
608 <context>http, server, location</context> 611 <context>http, server, location</context>
609 612
610 <para> 613 <para>
611 Директива задаёт таймаут при чтении ответа проксированного сервера. 614 Директива задаёт таймаут при чтении ответа проксированного сервера.
612 Таймаут устанавливается не на всю передачу ответа, 615 Таймаут устанавливается не на всю передачу ответа,
616 </para> 619 </para>
617 620
618 </directive> 621 </directive>
619 622
620 623
621 <directive name="proxy_redirect_errors">
622 <syntax>proxy_redirect_errors <value>[on|off]</value></syntax>
623
624 <para>
625 Директива переименована в <link id="proxy_intercept_errors"/>.
626 </para>
627
628 </directive>
629
630
631 <directive name="proxy_send_timeout"> 624 <directive name="proxy_send_timeout">
632 <syntax>proxy_send_timeout <value>время</value></syntax> 625 <syntax><value>время</value></syntax>
633 <default>proxy_send_timeout 60</default> 626 <default>60</default>
634 <context>http, server, location</context> 627 <context>http, server, location</context>
635 628
636 <para> 629 <para>
637 Директива задаёт таймаут при передаче запроса проксированному серверу. 630 Директива задаёт таймаут при передаче запроса проксированному серверу.
638 Таймаут устанавливается не на всю передачу запроса, 631 Таймаут устанавливается не на всю передачу запроса,
643 636
644 </directive> 637 </directive>
645 638
646 639
647 <directive name="proxy_set_header"> 640 <directive name="proxy_set_header">
648 <syntax>proxy_set_header <value>заголовок значение</value></syntax> 641 <syntax><value>заголовок значение</value></syntax>
649 <default>Host и Connection</default> 642 <default>Host $proxy_host</default>
643 <default>Connection close</default>
650 <context>http, server, location</context> 644 <context>http, server, location</context>
651 645
652 <para> 646 <para>
653 Директива позволяет переопределять или добавлять строки заголовка запроса, 647 Директива позволяет переопределять или добавлять строки заголовка запроса,
654 передаваемые проксируемому серверу. 648 передаваемые проксируемому серверу.
696 690
697 </directive> 691 </directive>
698 692
699 693
700 <directive name="proxy_ssl_session_reuse"> 694 <directive name="proxy_ssl_session_reuse">
701 <syntax>proxy_ssl_session_reuse <value>[on|off]</value></syntax> 695 <syntax><value>[on|off]</value></syntax>
702 <default>proxy_ssl_session_reuse on</default> 696 <default>on</default>
703 <context>http, server, location</context> 697 <context>http, server, location</context>
704 698
705 <para> 699 <para>
706 Директива определяет, использовать ли повторно SSL-сессии при 700 Директива определяет, использовать ли повторно SSL-сессии при
707 работе с проксированным сервером. Если в логах появляются ошибки 701 работе с проксированным сервером. Если в логах появляются ошибки
711 705
712 </directive> 706 </directive>
713 707
714 708
715 <directive name="proxy_store"> 709 <directive name="proxy_store">
716 <syntax>proxy_store <value>on | off | строка </value></syntax> 710 <syntax><value>on | off | строка </value></syntax>
717 <default>proxy_store off</default> 711 <default>off</default>
718 <context>http, server, location</context> 712 <context>http, server, location</context>
719 713
720 <para> 714 <para>
721 Директива разрешает сохранение на диск файлов. 715 Директива разрешает сохранение на диск файлов.
722 Параметр "on" сохраняет файлы в соответствии с путями, указаными в директивах 716 Параметр "on" сохраняет файлы в соответствии с путями, указаными в директивах
788 782
789 </directive> 783 </directive>
790 784
791 785
792 <directive name="proxy_store_access"> 786 <directive name="proxy_store_access">
793 <syntax>proxy_store_access <value>пользователи:права [пользователи:права] 787 <syntax><value>пользователи:права [пользователи:права]
794 ...</value></syntax> 788 ...</value></syntax>
795 <default>proxy_store_access user:rw</default> 789 <default>user:rw</default>
796 <context>http, server, location</context> 790 <context>http, server, location</context>
797 791
798 <para> 792 <para>
799 Директива задаёт права доступа для создаваемых файлов и каталогов, например, 793 Директива задаёт права доступа для создаваемых файлов и каталогов, например,
800 <example> 794 <example>
812 806
813 </directive> 807 </directive>
814 808
815 809
816 <directive name="proxy_temp_path"> 810 <directive name="proxy_temp_path">
817 <syntax>proxy_temp_path <value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ] 811 <syntax><value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ]
818 </value></syntax> 812 </value></syntax>
819 <default>proxy_temp_path proxy_temp</default> 813 <default>proxy_temp</default>
820 <context>http, server, location</context> 814 <context>http, server, location</context>
821 815
822 <para> 816 <para>
823 Директива задаёт имя каталога для хранения временных файлов 817 Директива задаёт имя каталога для хранения временных файлов
824 полученных от другого сервера. 818 полученных от другого сервера.