Mercurial > hg > nginx-site

comparison xml/ru/docs/http/ngx_http_proxy_module.xml @ 959:fbb4cc6f8c3d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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&mdash; 972 а при обработке изменённого URI&mdash;
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 использует параметры директив