Mercurial > hg > nginx-site
comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 959:fbb4cc6f8c3d
Text review of ngx_http_proxy_module.
author | Egor Nikitin <yegor.nikitin@gmail.com> |
---|---|
date | Wed, 07 Aug 2013 10:10:59 +0400 |
parents | ba3d6ade3513 |
children | 95c3c3bbf1ce |
comparison
equal
deleted
inserted
replaced
958:fd1f8e0a405e | 959:fbb4cc6f8c3d |
---|---|
52 исходящих соединениях с проксируемым сервером. | 52 исходящих соединениях с проксируемым сервером. |
53 В значении параметра допустимо использование переменных (1.3.12). | 53 В значении параметра допустимо использование переменных (1.3.12). |
54 Специальное значение <literal>off</literal> (1.3.12) отменяет действие | 54 Специальное значение <literal>off</literal> (1.3.12) отменяет действие |
55 унаследованной с предыдущего уровня конфигурации | 55 унаследованной с предыдущего уровня конфигурации |
56 директивы <literal>proxy_bind</literal>, позволяя системе | 56 директивы <literal>proxy_bind</literal>, позволяя системе |
57 самостоятельно выбирать локальный адрес. | 57 самостоятельно выбирать локальный IP-адрес. |
58 </para> | 58 </para> |
59 | 59 |
60 </directive> | 60 </directive> |
61 | 61 |
62 | 62 |
149 проксируемого сервера, ограничивает суммарный <value>размер</value> | 149 проксируемого сервера, ограничивает суммарный <value>размер</value> |
150 буферов, которые могут быть заняты для отправки ответа клиенту, пока | 150 буферов, которые могут быть заняты для отправки ответа клиенту, пока |
151 ответ ещё не прочитан целиком. | 151 ответ ещё не прочитан целиком. |
152 Оставшиеся буферы тем временем могут использоваться для чтения ответа | 152 Оставшиеся буферы тем временем могут использоваться для чтения ответа |
153 и, при необходимости, буферизации части ответа во временный файл. | 153 и, при необходимости, буферизации части ответа во временный файл. |
154 По умолчанию <value>размер</value> ограничен двумя буферами, заданными | 154 По умолчанию <value>размер</value> ограничен величиной двух буферов, заданных |
155 директивами <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>. | 155 директивами <link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>. |
156 </para> | 156 </para> |
157 | 157 |
158 </directive> | 158 </directive> |
159 | 159 |
533 proxy_cookie_domain ~\.([a-z]+\.[a-z]+)$ $1; | 533 proxy_cookie_domain ~\.([a-z]+\.[a-z]+)$ $1; |
534 </example> | 534 </example> |
535 </para> | 535 </para> |
536 | 536 |
537 <para> | 537 <para> |
538 Параметр <literal>off</literal> запрещает все директивы | 538 Параметр <literal>off</literal> отменяет действие всех директив |
539 <literal>proxy_cookie_domain</literal> | 539 <literal>proxy_cookie_domain</literal> |
540 на данном уровне: | 540 на данном уровне: |
541 <example> | 541 <example> |
542 proxy_cookie_domain off; | 542 proxy_cookie_domain off; |
543 proxy_cookie_domain localhost example.org; | 543 proxy_cookie_domain localhost example.org; |
599 proxy_cookie_path / /two/; | 599 proxy_cookie_path / /two/; |
600 </example> | 600 </example> |
601 </para> | 601 </para> |
602 | 602 |
603 <para> | 603 <para> |
604 Параметр <literal>off</literal> запрещает все директивы | 604 Параметр <literal>off</literal> отменяет действие всех директив |
605 <literal>proxy_cookie_path</literal> | 605 <literal>proxy_cookie_path</literal> |
606 на данном уровне: | 606 на данном уровне: |
607 <example> | 607 <example> |
608 proxy_cookie_path off; | 608 proxy_cookie_path off; |
609 proxy_cookie_path /two/ /; | 609 proxy_cookie_path /two/ /; |
787 Если включена <link id="proxy_buffering">буферизация</link> ответов | 787 Если включена <link id="proxy_buffering">буферизация</link> ответов |
788 проксируемого сервера, и ответ не вмещается целиком в буферы памяти, | 788 проксируемого сервера, и ответ не вмещается целиком в буферы памяти, |
789 заданные директивами <link id="proxy_buffer_size"/> и | 789 заданные директивами <link id="proxy_buffer_size"/> и |
790 <link id="proxy_buffers"/>, часть ответа может быть записана во временный файл. | 790 <link id="proxy_buffers"/>, часть ответа может быть записана во временный файл. |
791 Эта директива задаёт максимальный <value>размер</value> временного файла. | 791 Эта директива задаёт максимальный <value>размер</value> временного файла. |
792 Размер данных, сбрасываемых во временный файл за один раз, задаётся | 792 Размер данных, записываемых во временный файл за один раз, задаётся |
793 директивой <link id="proxy_temp_file_write_size"/>. | 793 директивой <link id="proxy_temp_file_write_size"/>. |
794 </para> | 794 </para> |
795 | 795 |
796 <para> | 796 <para> |
797 Значение 0 отключает возможность буферизации ответов во временные файлы. | 797 Значение 0 отключает буферизацию ответов во временные файлы. |
798 </para> | 798 </para> |
799 | 799 |
800 </directive> | 800 </directive> |
801 | 801 |
802 | 802 |
874 </para> | 874 </para> |
875 | 875 |
876 <para> | 876 <para> |
877 Необходимо понимать, что передача запроса следующему серверу возможна | 877 Необходимо понимать, что передача запроса следующему серверу возможна |
878 только при условии, что клиенту ещё ничего не передавалось. | 878 только при условии, что клиенту ещё ничего не передавалось. |
879 То есть, если ошибка или таймаут возникли в середине передачи ответа, | 879 То есть, если ошибка или таймаут возникли в середине передачи ответа |
880 то исправить это уже невозможно. | 880 клиенту, то исправить это уже невозможно. |
881 </para> | 881 </para> |
882 | 882 |
883 <para> | 883 <para> |
884 Директива также определяет, что считается неудачной попыткой работы с | 884 Директива также определяет, что считается неудачной попыткой работы с |
885 <link doc="ngx_http_upstream_module.xml" id="server">сервером</link>. | 885 <link doc="ngx_http_upstream_module.xml" id="server">сервером</link>. |
951 <para> | 951 <para> |
952 URI запроса передаётся на сервер так: | 952 URI запроса передаётся на сервер так: |
953 <list type="bullet" compact="no"> | 953 <list type="bullet" compact="no"> |
954 | 954 |
955 <listitem> | 955 <listitem> |
956 Если <literal>proxy_pass</literal> указана с URI, | 956 Если директива <literal>proxy_pass</literal> указана с URI, |
957 то при передаче запроса серверу часть | 957 то при передаче запроса серверу часть |
958 <link doc="ngx_http_core_module.xml" id="location">нормализованного</link> | 958 <link doc="ngx_http_core_module.xml" id="location">нормализованного</link> |
959 URI запроса, соответствующая location, заменяется на URI, | 959 URI запроса, соответствующая location, заменяется на URI, |
960 указанный в директиве: | 960 указанный в директиве: |
961 <example> | 961 <example> |
964 } | 964 } |
965 </example> | 965 </example> |
966 </listitem> | 966 </listitem> |
967 | 967 |
968 <listitem> | 968 <listitem> |
969 Если <literal>proxy_pass</literal> указана без URI, | 969 Если директива <literal>proxy_pass</literal> указана без URI, |
970 то при обработке первоначального запроса на сервер передаётся | 970 то при обработке первоначального запроса на сервер передаётся |
971 URI запроса в том же виде, в каком его прислал клиент, | 971 URI запроса в том же виде, в каком его прислал клиент, |
972 а при обработке изменённого URI— | 972 а при обработке изменённого URI— |
973 нормализованный URI запроса целиком: | 973 нормализованный URI запроса целиком: |
974 <example> | 974 <example> |
1082 <context>http</context> | 1082 <context>http</context> |
1083 <context>server</context> | 1083 <context>server</context> |
1084 <context>location</context> | 1084 <context>location</context> |
1085 | 1085 |
1086 <para> | 1086 <para> |
1087 Если запрещено, то исходное тело запроса не будет передано | 1087 Позволяет запретить передачу исходного тела запроса |
1088 на проксируемый сервер. | 1088 на проксируемый сервер. |
1089 <example> | 1089 <example> |
1090 location /x-accel-redirect-here/ { | 1090 location /x-accel-redirect-here/ { |
1091 proxy_method GET; | 1091 proxy_method GET; |
1092 proxy_pass_request_body off; | 1092 proxy_pass_request_body off; |
1108 <context>http</context> | 1108 <context>http</context> |
1109 <context>server</context> | 1109 <context>server</context> |
1110 <context>location</context> | 1110 <context>location</context> |
1111 | 1111 |
1112 <para> | 1112 <para> |
1113 Если запрещено, то поля заголовка исходного запроса не будут переданы на | 1113 Позволяет запретить передачу полей заголовка исходного запроса на |
1114 проксируемый сервер. | 1114 проксируемый сервер. |
1115 <example> | 1115 <example> |
1116 location /x-accel-redirect-here/ { | 1116 location /x-accel-redirect-here/ { |
1117 proxy_method GET; | 1117 proxy_method GET; |
1118 proxy_pass_request_headers off; | 1118 proxy_pass_request_headers off; |
1154 <para> | 1154 <para> |
1155 В заменяемой строке можно не указывать имя сервера: | 1155 В заменяемой строке можно не указывать имя сервера: |
1156 <example> | 1156 <example> |
1157 proxy_redirect http://localhost:8000/two/ /; | 1157 proxy_redirect http://localhost:8000/two/ /; |
1158 </example> | 1158 </example> |
1159 тогда будет подставлено основное имя сервера и порт, если он отличен от 80. | 1159 тогда будут подставлены основное имя сервера и порт, если он отличен от 80. |
1160 </para> | 1160 </para> |
1161 | 1161 |
1162 <para> | 1162 <para> |
1163 Стандартная замена, задаваемая параметром <literal>default</literal>, | 1163 Стандартная замена, задаваемая параметром <literal>default</literal>, |
1164 использует параметры директив | 1164 использует параметры директив |