Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 271:4c6d2c614d2c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Cleaned up XML tag mess: - all of <parameter> and <code>, and some of <dirname>, <value>, and <command> were replaced by <literal>; - the rest of <dirname> were replaced by links; - <argument> were replaced by <value>; - <value> is now rendered in HTML in italic; - <literal> and <path> can now contain <value>. Cleaned up terminology mess: - directives take "parameters".
author Ruslan Ermilov <ru@nginx.com>
date Fri, 23 Dec 2011 17:29:59 +0000
parents c78b2d6fe261
children 44ab4026d9f5
comparison
equal deleted inserted replaced
270:945d7299c26c 271:4c6d2c614d2c
47 47
48 </directive> 48 </directive>
49 49
50 50
51 <directive name="proxy_buffering"> 51 <directive name="proxy_buffering">
52 <syntax><value>on|off</value></syntax> 52 <syntax><literal>on</literal> | <literal>off</literal></syntax>
53 <default>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 Директива разрешает использовать буферизацию ответа проксируемого сервера.
70 70
71 </directive> 71 </directive>
72 72
73 73
74 <directive name="proxy_buffers"> 74 <directive name="proxy_buffers">
75 <syntax><value>число размер</value></syntax> 75 <syntax><value>число</value> <value>размер</value></syntax>
76 <default>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 Директива задаёт число и размер буферов для одного соединения,
85 85
86 </directive> 86 </directive>
87 87
88 88
89 <directive name="proxy_cache"> 89 <directive name="proxy_cache">
90 <syntax><value>[зона|off]</value></syntax> 90 <syntax><value>зона</value> | <literal>off</literal></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><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 Директива задаёт условия, при которых ответ не будет браться из кэша.
138 138
139 </directive> 139 </directive>
140 140
141 141
142 <directive name="proxy_cache_path"> 142 <directive name="proxy_cache_path">
143 <syntax><value>путь [levels=уровни] 143 <syntax>
144 keys_zone=название:размер [inactive=время] [max_size=размер]</value></syntax> 144 <value>путь</value>
145 [<literal>levels</literal>=<value>уровни</value>]
146 <literal>keys_zone</literal>=<value>название</value>:<value>размер</value>
147 [<literal>inactive</literal>=<value>время</value>]
148 [<literal>max_size</literal>=<value>размер</value>]</syntax>
145 <default/> 149 <default/>
146 <context>http</context> 150 <context>http</context>
147 151
148 <para> 152 <para>
149 Директива задаёт путь и другие параметры кэша. Данные кэша хранятся в файлах. 153 Директива задаёт путь и другие параметры кэша. Данные кэша хранятся в файлах.
199 203
200 </directive> 204 </directive>
201 205
202 206
203 <directive name="proxy_cache_valid"> 207 <directive name="proxy_cache_valid">
204 <syntax><value>ответ [ответ ...] время</value> 208 <syntax><value>ответ</value> ... <value>время</value></syntax>
205 </syntax>
206 <default/> 209 <default/>
207 <context>http, server, location</context> 210 <context>http, server, location</context>
208 211
209 <para> 212 <para>
210 Директива задаёт время кэширования для разных ответов. 213 Директива задаёт время кэширования для разных ответов.
236 239
237 </directive> 240 </directive>
238 241
239 242
240 <directive name="proxy_cache_use_stale"> 243 <directive name="proxy_cache_use_stale">
241 <syntax><value>[error | timeout | invalid_header 244 <syntax>
242 | updating | http_500 | http_502 | http_503 | http_504 | http_404 | off] 245 <literal>error</literal> |
243 [...]</value></syntax> 246 <literal>timeout</literal> |
247 <literal>invalid_header</literal> |
248 <literal>updating</literal> |
249 <literal>http_500</literal> |
250 <literal>http_502</literal> |
251 <literal>http_503</literal> |
252 <literal>http_504</literal> |
253 <literal>http_404</literal> |
254 <literal>off</literal>
255 ...</syntax>
244 <default>off</default> 256 <default>off</default>
245 <context>http, server, location</context> 257 <context>http, server, location</context>
246 258
247 <para> 259 <para>
248 Директива определяет, в каких случаях можно использовать 260 Директива определяет, в каких случаях можно использовать
284 296
285 </directive> 297 </directive>
286 298
287 299
288 <directive name="proxy_ignore_client_abort"> 300 <directive name="proxy_ignore_client_abort">
289 <syntax><value>[on|off]</value></syntax> 301 <syntax><literal>on</literal> | <literal>off</literal></syntax>
290 <default>off</default> 302 <default>off</default>
291 <context>http, server, location</context> 303 <context>http, server, location</context>
292 304
293 <para> 305 <para>
294 Директива определяет, закрывать ли соединение с проксированным сервером 306 Директива определяет, закрывать ли соединение с проксированным сервером
297 309
298 </directive> 310 </directive>
299 311
300 312
301 <directive name="proxy_ignore_headers"> 313 <directive name="proxy_ignore_headers">
302 <syntax><value>имя [имя ...]</value></syntax> 314 <syntax><value>имя</value> ...</syntax>
303 <default/> 315 <default/>
304 <context>http, server, location</context> 316 <context>http, server, location</context>
305 317
306 <para> 318 <para>
307 Директива proxy_ignore_headers запрещает обработку некоторых 319 Директива proxy_ignore_headers запрещает обработку некоторых
313 325
314 </directive> 326 </directive>
315 327
316 328
317 <directive name="proxy_intercept_errors"> 329 <directive name="proxy_intercept_errors">
318 <syntax><value>[on|off]</value></syntax> 330 <syntax><literal>on</literal> | <literal>off</literal></syntax>
319 <default>off</default> 331 <default>off</default>
320 <context>http, server, location</context> 332 <context>http, server, location</context>
321 333
322 <para> 334 <para>
323 Директива определяет, передавать ли клиенту проксированные ответы с кодом 335 Директива определяет, передавать ли клиенту проксированные ответы с кодом
327 339
328 </directive> 340 </directive>
329 341
330 342
331 <directive name="proxy_next_upstream"> 343 <directive name="proxy_next_upstream">
332 <syntax><value>[error | timeout | invalid_header 344 <syntax>
333 | http_500 | http_502 | http_503 | http_504 | http_404 | off] 345 <literal>error</literal> |
334 [...]</value></syntax> 346 <literal>timeout</literal> |
347 <literal>invalid_header</literal> |
348 <literal>http_500</literal> |
349 <literal>http_502</literal> |
350 <literal>http_503</literal> |
351 <literal>http_504</literal> |
352 <literal>http_404</literal> |
353 <literal>off</literal>
354 ...</syntax>
335 <default>error timeout</default> 355 <default>error timeout</default>
336 <context>http, server, location</context> 356 <context>http, server, location</context>
337 357
338 <para> 358 <para>
339 Директива определяет, в каких случаях запрос будет передан следующему серверу: 359 Директива определяет, в каких случаях запрос будет передан следующему серверу:
389 409
390 </directive> 410 </directive>
391 411
392 412
393 <directive name="proxy_no_cache"> 413 <directive name="proxy_no_cache">
394 <syntax><value>строка [...]</value></syntax> 414 <syntax><value>строка</value> ...</syntax>
395 <default/> 415 <default/>
396 <context>http, server, location</context> 416 <context>http, server, location</context>
397 417
398 <para> 418 <para>
399 Директива задаёт условия, при которых ответ не будет сохраняться в кэш. 419 Директива задаёт условия, при которых ответ не будет сохраняться в кэш.
527 </directive> 547 </directive>
528 548
529 549
530 <directive name="proxy_redirect"> 550 <directive name="proxy_redirect">
531 <syntax> 551 <syntax>
532 <value>default</value> | 552 <literal>default</literal> |
533 <value>off</value> | 553 <literal>off</literal> |
534 <argument>перенаправление замена</argument> 554 <value>перенаправление</value> <value>замена</value></syntax>
535 </syntax>
536 <default>default</default> 555 <default>default</default>
537 <context>http</context> 556 <context>http</context>
538 <context>server</context> 557 <context>server</context>
539 <context>location</context> 558 <context>location</context>
540 559
559 </example> 578 </example>
560 тогда будет подставлено основное имя сервера и порт, если он отличен от 80. 579 тогда будет подставлено основное имя сервера и порт, если он отличен от 80.
561 </para> 580 </para>
562 581
563 <para> 582 <para>
564 Изменение по умолчанию, задаваемое значением <value>default</value>, использует 583 Изменение по умолчанию, задаваемое значением <literal>default</literal>, использует
565 параметры директив <link doc="ngx_http_core_module.xml" id="location"/> и 584 параметры директив <link doc="ngx_http_core_module.xml" id="location"/> и
566 <link id="proxy_pass"/>. 585 <link id="proxy_pass"/>.
567 Поэтому две нижеприведённые конфигурации одинаковы: 586 Поэтому две нижеприведённые конфигурации одинаковы:
568 <example> 587 <example>
569 location /one/ { 588 location /one/ {
574 <example> 593 <example>
575 location /one/ { 594 location /one/ {
576 proxy_pass http://upstream:port/two/; 595 proxy_pass http://upstream:port/two/;
577 proxy_redirect http://upstream:port/two/ /one/; 596 proxy_redirect http://upstream:port/two/ /one/;
578 </example> 597 </example>
579 Значение <value>default</value> недопустимо, если в <link id="proxy_pass"/> 598 Значение <literal>default</literal> недопустимо, если в <link id="proxy_pass"/>
580 используются переменные. 599 используются переменные.
581 </para> 600 </para>
582 601
583 <para> 602 <para>
584 В заменяемой строке можно использовать переменные: 603 В заменяемой строке можно использовать переменные:
594 </example> 613 </example>
595 </para> 614 </para>
596 615
597 <para> 616 <para>
598 Директиву также можно задать (1.1.11) при помощи регулярных выражений. 617 Директиву также можно задать (1.1.11) при помощи регулярных выражений.
599 При этом <argument>перенаправление</argument> должен начинаться либо с символа 618 При этом <value>перенаправление</value> должно начинаться либо с символа
600 “<code>~</code>”, если при сравнении следует учитывать регистр символов, 619 “<literal>~</literal>”, если при сравнении следует учитывать регистр символов,
601 либо с символов “<code>~*</code>”, если регистр символов учитывать не нужно. 620 либо с символов “<literal>~*</literal>”, если регистр символов учитывать
621 не нужно.
602 Регулярное выражение может содержать именованные и позиционные выделения, 622 Регулярное выражение может содержать именованные и позиционные выделения,
603 а <argument>замена</argument> на них ссылаться: 623 а <value>замена</value> ссылаться на них:
604 <example> 624 <example>
605 proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2; 625 proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2;
606 proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2; 626 proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2;
607 </example> 627 </example>
608 </para> 628 </para>
615 proxy_redirect http://www.example.com/ /; 635 proxy_redirect http://www.example.com/ /;
616 </example> 636 </example>
617 </para> 637 </para>
618 638
619 <para> 639 <para>
620 Значение <value>off</value> запрещает все директивы <code>proxy_redirect</code> 640 Значение <literal>off</literal> запрещает все директивы
641 <literal>proxy_redirect</literal>
621 на данном уровне: 642 на данном уровне:
622 <example> 643 <example>
623 proxy_redirect off; 644 proxy_redirect off;
624 proxy_redirect default; 645 proxy_redirect default;
625 proxy_redirect http://localhost:8000/ /; 646 proxy_redirect http://localhost:8000/ /;
669 690
670 </directive> 691 </directive>
671 692
672 693
673 <directive name="proxy_set_header"> 694 <directive name="proxy_set_header">
674 <syntax><value>заголовок значение</value></syntax> 695 <syntax><value>заголовок</value> <value>значение</value></syntax>
675 <default>Host $proxy_host</default> 696 <default>Host $proxy_host</default>
676 <default>Connection close</default> 697 <default>Connection close</default>
677 <context>http, server, location</context> 698 <context>http, server, location</context>
678 699
679 <para> 700 <para>
723 744
724 </directive> 745 </directive>
725 746
726 747
727 <directive name="proxy_ssl_session_reuse"> 748 <directive name="proxy_ssl_session_reuse">
728 <syntax><value>[on|off]</value></syntax> 749 <syntax><literal>on</literal> | <literal>off</literal></syntax>
729 <default>on</default> 750 <default>on</default>
730 <context>http, server, location</context> 751 <context>http, server, location</context>
731 752
732 <para> 753 <para>
733 Директива определяет, использовать ли повторно SSL-сессии при 754 Директива определяет, использовать ли повторно SSL-сессии при
738 759
739 </directive> 760 </directive>
740 761
741 762
742 <directive name="proxy_store"> 763 <directive name="proxy_store">
743 <syntax><value>on | off | строка </value></syntax> 764 <syntax><literal>on</literal> | <literal>off</literal> | <value>строка</value></syntax>
744 <default>off</default> 765 <default>off</default>
745 <context>http, server, location</context> 766 <context>http, server, location</context>
746 767
747 <para> 768 <para>
748 Директива разрешает сохранение на диск файлов. 769 Директива разрешает сохранение на диск файлов.
815 836
816 </directive> 837 </directive>
817 838
818 839
819 <directive name="proxy_store_access"> 840 <directive name="proxy_store_access">
820 <syntax><value>пользователи:права [пользователи:права] 841 <syntax><value>пользователи</value>:<value>права</value> ...</syntax>
821 ...</value></syntax>
822 <default>user:rw</default> 842 <default>user:rw</default>
823 <context>http, server, location</context> 843 <context>http, server, location</context>
824 844
825 <para> 845 <para>
826 Директива задаёт права доступа для создаваемых файлов и каталогов, например, 846 Директива задаёт права доступа для создаваемых файлов и каталогов, например,
839 859
840 </directive> 860 </directive>
841 861
842 862
843 <directive name="proxy_temp_path"> 863 <directive name="proxy_temp_path">
844 <syntax><value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ] 864 <syntax><value>путь</value> [<value>уровень1</value> [<value>уровень2</value> [<value>уровень3</value>]]]</syntax>
845 </value></syntax>
846 <default>proxy_temp</default> 865 <default>proxy_temp</default>
847 <context>http, server, location</context> 866 <context>http, server, location</context>
848 867
849 <para> 868 <para>
850 Директива задаёт имя каталога для хранения временных файлов 869 Директива задаёт имя каталога для хранения временных файлов