<?xml version="1.0"?>

<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">

<module name="Модуль ngx_http_proxy_module"
        link="/ru/docs/http/ngx_http_proxy_module.html"
        lang="ru">

<section id="summary">

<para>
Модуль <literal>ngx_http_proxy_module</literal> позволяет передавать
запросы другому серверу.
</para>

</section>


<section id="example" name="Пример конфигурации">

<para>
<example>
location / {
    proxy_pass       http://localhost:8000;
    proxy_set_header Host      $host;
    proxy_set_header X-Real-IP $remote_addr;
}
</example>
</para>

</section>


<section id="directives" name="Директивы">

<directive name="proxy_buffer_size">
<syntax><value>размер</value></syntax>
<default>4k|8k</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт размер буфера, в который будет читаться
первая часть ответа, получаемого от проксируемого сервера.
В этой части ответа находится, как правило, небольшой заголовок ответа.
По умолчанию размер буфера равен размеру одного буфера в директиве
<link id="proxy_buffers"/>, однако его можно сделать меньше.
</para>

</directive>


<directive name="proxy_buffering">
<syntax><literal>on</literal> | <literal>off</literal></syntax>
<default>on</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Разрешает или запрещает использовать буферизацию ответа проксируемого сервера.
</para>

<para>
Если буферизация включена, то nginx принимает ответ проксируемого сервера
как можно быстрее, сохраняя его в буферы, заданные директивами
<link id="proxy_buffer_size"/> и <link id="proxy_buffers"/>.
Если ответ не вмещается целиком в память, то его часть записывается на диск.
</para>

<para>
Если буферизация выключена, то ответ синхронно передаётся клиенту сразу же
по мере его поступления.
nginx не пытается считать весь ответ проксируемого сервера.
Максимальный размер данных, который nginx может принять от сервера,
задаётся директивой <link id="proxy_buffer_size"/>.
</para>

</directive>


<directive name="proxy_buffers">
<syntax><value>число</value> <value>размер</value></syntax>
<default>8 4k|8k</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт число и размер буферов для одного соединения,
в которые будет читаться ответ, получаемый от проксируемого сервера.
По умолчанию размер одного буфера равен размеру страницы.
В зависимости от платформы это или 4K, или 8K.
</para>

</directive>


<directive name="proxy_cache">
<syntax><value>зона</value> | <literal>off</literal></syntax>
<default>off</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт зону для кэширования.
Одна и та же зона может использоваться в нескольких местах.
Параметр <literal>off</literal> запрещает кэширование, унаследованное
с предыдущего уровня конфигурации.
</para>

</directive>


<directive name="proxy_cache_bypass">
<syntax><value>строка</value> ...</syntax>
<default/>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт условия, при которых ответ не будет браться из кэша.
Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
то ответ не берётся из кэша:
<example>
proxy_cache_bypass $cookie_nocache $arg_nocache$arg_comment;
proxy_cache_bypass $http_pragma    $http_authorization;
</example>
Можно использовать совместно с директивой <link id="proxy_no_cache"/>.
</para>

</directive>


<directive name="proxy_cache_key">
<syntax><value>строка</value></syntax>
<default>$scheme$proxy_host$request_uri</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт ключ для кэширования, например,
<example>
proxy_cache_key "$host$request_uri $cookie_user";
</example>
По умолчанию значение директивы близко к строке
<example>
proxy_cache_key $scheme$proxy_host$uri$is_args$args;
</example>
</para>

</directive>


<directive name="proxy_cache_min_uses">
<syntax><value>число</value></syntax>
<default>1</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт число запросов, после которого ответ будет закэширован.
</para>

</directive>


<directive name="proxy_cache_path">
<syntax>
  <value>путь</value>
  [<literal>levels</literal>=<value>уровни</value>]
  <literal>keys_zone</literal>=<value>название</value>:<value>размер</value>
  [<literal>inactive</literal>=<value>время</value>]
  [<literal>max_size</literal>=<value>размер</value>]</syntax>
<default/>
<context>http</context>

<para>
Задаёт путь и другие параметры кэша.
Данные кэша хранятся в файлах.
Ключом и именем файла в кэше является результат функции MD5
от проксированного URL.
Параметр <literal>levels</literal> задаёт уровни иерархии кэша,
например, при использовании
<example>
proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=one:10m;
</example>
имена файлов в кэше будут такого вида:
<example>
/data/nginx/cache/<emphasis>c/29</emphasis>/b7f54b2df7773722d382f4809d650<emphasis>29c</emphasis>
</example>
</para>

<para>
Кэшируемый ответ записывается во временный файл, а потом этот файл
переименовывается. Начиная с версии 0.8.9, временные файлы и кэш
могут располагаться на разных файловых системах, но нужно учитывать,
что в этом случае вместо дешёвой операции переименовывания в пределах
одной файловой системы файл копируется с одной файловой системы на другую.
Поэтому лучше, если кэш будет находиться на той же файловой
системе, что и каталог с временными файлами, задаваемый директивой
<link id="proxy_temp_path"/> для данного location.
</para>

<para>
Кроме того, все активные ключи и информация о данных хранятся в разделяемой
памяти — зоне, имя и размер которой задаётся параметром
<literal>keys_zone</literal>.
Если к данным кэша не обращаются в течение времени, заданного параметром
<literal>inactive</literal>, то данные удаляются, независимо от их свежести.
По умолчанию <literal>inactive</literal> равен 10 минутам.
</para>

<para>
Специальный процесс “cache manager” следит за максимальным размером кэша,
заданным параметром <literal>max_size</literal>, и при превышении
его размеров удаляет самые невостребованные данные.
</para>

</directive>


<directive name="proxy_cache_use_stale">
<syntax>
  <literal>error</literal> |
  <literal>timeout</literal> |
  <literal>invalid_header</literal> |
  <literal>updating</literal> |
  <literal>http_500</literal> |
  <literal>http_502</literal> |
  <literal>http_503</literal> |
  <literal>http_504</literal> |
  <literal>http_404</literal> |
  <literal>off</literal>
  ...</syntax>
<default>off</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Определяет, в каких случаях можно использовать
устаревший закэшированный ответ, если при работе с проксированным
сервером возникла ошибка. Параметры директивы совпадают с параметрами
директивы <link id="proxy_next_upstream"/>.
Кроме того, дополнительный параметр <literal>updating</literal>
разрешает использовать устаревший закэшированный ответ,
если на данный момент он уже обновляется.
</para>

</directive>


<directive name="proxy_cache_valid">
<syntax>[<value>код</value> ...] <value>время</value></syntax>
<default/>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт время кэширования для разных кодов ответа.
Например, директивы
<example>
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404      1m;
</example>
задают время кэширования 10 минут для ответов с кодами 200 и 302,
и 1 минуту для ответов с кодом 404.
</para>

<para>
Если указано только <value>время</value> кэширования,
<example>
proxy_cache_valid 5m;
</example>
то кэшируются только ответы 200, 301 и 302.
</para>

<para>
Кроме того, можно кэшировать любые ответы с помощью параметра
<literal>any</literal>:
<example>
proxy_cache_valid 200 302 10m;
proxy_cache_valid 301      1h;
proxy_cache_valid any      1m;
</example>
</para>

</directive>


<directive name="proxy_connect_timeout">
<syntax><value>время</value></syntax>
<default>60s</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт таймаут для соединения с проксированным сервером.
Необходимо иметь в виду, что этот таймаут не может быть больше 75 секунд.
</para>

</directive>


<directive name="proxy_hide_header">
<syntax><value>имя</value></syntax>
<default/>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
nginx не передаёт клиенту поля заголовка <header>Date</header>,
<header>Server</header>, <header>X-Pad</header> и
<header>X-Accel-...</header> из ответа проксированного сервера.
Директива <literal>proxy_hide_header</literal> задаёт дополнительные поля.
Если же поля нужно напротив разрешить, следует воспользоваться
директивой <link id="proxy_pass_header"/>.
</para>

</directive>


<directive name="proxy_ignore_client_abort">
<syntax><literal>on</literal> | <literal>off</literal></syntax>
<default>off</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Определяет, закрывать ли соединение с проксированным сервером
в случае, если клиент закрыл соединение, не дождавшись ответа.
</para>

</directive>


<directive name="proxy_ignore_headers">
<syntax><value>поле</value> ...</syntax>
<default/>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Запрещает обработку некоторых полей заголовка из ответа проксированного сервера.
В директиве можно указать поля <header>X-Accel-Redirect</header>,
<header>X-Accel-Expires</header>, <header>X-Accel-Limit-Rate</header> (1.1.6),
<header>X-Accel-Buffering</header> (1.1.6),
<header>X-Accel-Charset</header> (1.1.6), <header>Expires</header>,
<header>Cache-Control</header> и <header>Set-Cookie</header> (0.8.44).
</para>

</directive>


<directive name="proxy_intercept_errors">
<syntax><literal>on</literal> | <literal>off</literal></syntax>
<default>off</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Определяет, передавать ли клиенту проксированные ответы с кодом
больше либо равным 400, или же перенаправлять их на обработку nginx'у с помощью
директивы <link doc="ngx_http_core_module.xml" id="error_page"/>.
</para>

</directive>


<directive name="proxy_next_upstream">
<syntax>
  <literal>error</literal> |
  <literal>timeout</literal> |
  <literal>invalid_header</literal> |
  <literal>http_500</literal> |
  <literal>http_502</literal> |
  <literal>http_503</literal> |
  <literal>http_504</literal> |
  <literal>http_404</literal> |
  <literal>off</literal>
  ...</syntax>
<default>error timeout</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Определяет, в каких случаях запрос будет передан следующему серверу:
<list type="tag">

<tag-name><literal>error</literal></tag-name>
<tag-desc>произошла ошибка соединения с сервером, передачи ему запроса или
чтения заголовка ответа сервера;</tag-desc>

<tag-name><literal>timeout</literal></tag-name>
<tag-desc>произошёл таймаут во время соединения с сервером,
передачи ему запроса или чтения заголовка ответа сервера;</tag-desc>

<tag-name><literal>invalid_header</literal></tag-name>
<tag-desc>сервер вернул пустой или неверный ответ;</tag-desc>

<tag-name><literal>http_500</literal></tag-name>
<tag-desc>сервер вернул ответ с кодом 500;</tag-desc>

<tag-name><literal>http_502</literal></tag-name>
<tag-desc>сервер вернул ответ с кодом 502;</tag-desc>

<tag-name><literal>http_503</literal></tag-name>
<tag-desc>сервер вернул ответ с кодом 503;</tag-desc>

<tag-name><literal>http_504</literal></tag-name>
<tag-desc>сервер вернул ответ с кодом 504;</tag-desc>

<tag-name><literal>http_404</literal></tag-name>
<tag-desc>сервер вернул ответ с кодом 404;</tag-desc>

<tag-name><literal>off</literal></tag-name>
<tag-desc>запрещает передачу запроса следующему серверу.</tag-desc>

</list>
</para>

<para>
Необходимо понимать, что передача запроса следующему серверу возможна
только при условии, что клиенту ещё ничего не передавалось.
То есть, если ошибка или таймаут возникли в середине передачи ответа,
то исправить это уже невозможно.
</para>

</directive>


<directive name="proxy_no_cache">
<syntax><value>строка</value> ...</syntax>
<default/>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт условия, при которых ответ не будет сохраняться в кэш.
Если значение хотя бы одного из строковых параметров непустое и не равно “0”,
то ответ не будет сохранён:
<example>
proxy_no_cache $cookie_nocache $arg_nocache$arg_comment;
proxy_no_cache $http_pragma    $http_authorization;
</example>
Можно использовать совместно с директивой <link id="proxy_cache_bypass"/>.
</para>

</directive>


<directive name="proxy_pass">
<syntax><value>URL</value></syntax>
<default/>
<context>location</context>
<context>if в location</context>
<context>limit_except</context>

<para>
Задаёт адрес проксируемоего сервера и URI, на который
будет отображаться location.
Адрес может быть указан в виде доменного имени или адреса и порта, например,
<example>
    proxy_pass http://localhost:8000/uri/;
</example>
или в виде пути UNIX-сокета:
<example>
    proxy_pass http://unix:/tmp/backend.socket:/uri/;
</example>
путь указан после слова “<literal>unix</literal>”
и заключён между двумя двоеточиями.
</para>

<para>
Если доменному имени соответствует несколько адресов, то все они будут
использоваться по очереди (round-robin).
И, кроме того, адрес можно задать
<link doc="ngx_http_upstream_module.xml">группой серверов</link>.
</para>

<para>
При передаче запроса серверу часть URI, соответствующая location,
заменяется на URI, указанный в директиве <literal>proxy_pass</literal>.
Но из этого правила есть два исключения, в которых нельзя определить
заменяемый location:
<list type="bullet">

<listitem>
если location задан регулярным выражением;
</listitem>

<listitem>
если внутри проксируемого location с помощью директивы
<link doc="ngx_http_rewrite_module.xml" id="rewrite"/> изменяется
URI, и именно с этой конфигурацией будет обрабатываться запрос
(<literal>break</literal>):
<example>
location /name/ {
    rewrite    /name/([^/]+) /users?name=$1 break;
    proxy_pass http://127.0.0.1;
}
</example>
Для этих случаев URI передаётся без отображения.
</listitem>

</list>
</para>

<para>
Кроме того, можно указать, чтобы URI запроса передавался в том же виде,
в каком его прислал клиент, а не в обработанном виде.
Во время обработки
<list type="bullet">

<listitem>
два и более слэшей заменяются на один: “//” — “/”;
</listitem>

<listitem>
убираются ссылки на текущий каталог: “/./” — “/”;
</listitem>

<listitem>
убираются ссылки на предыдущий каталог: “/dir/../” — “/”.
</listitem>

</list>
</para>

<para>
Если на сервер нужно передать URI в необработанном виде, то для этого
в директиве <literal>proxy_pass</literal> нужно указать URL сервера без URI:
<example>
location /some/path/ {
    proxy_pass http://127.0.0.1;
}
</example>
</para>

<para>
Имя сервера, его порт и передаваемый URI можно также полностью задать
с помощью переменных:
<example>
    proxy_pass http://$host$uri;
</example>
или так:
<example>
    proxy_pass $request;
</example>
</para>

<para>
В этом случае имя сервера ищется среди описанных
<link doc="ngx_http_upstream_module.xml">групп серверов</link>
и если не найдено, то определяется с помощью
<link doc="ngx_http_core_module.xml" id="resolver"/>'а.
</para>

</directive>


<directive name="proxy_pass_header">
<syntax><value>поле</value></syntax>
<default/>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Разрешает передавать от проксируемого сервера клиенту
<link id="proxy_hide_header">запрещённые для передачи</link> поля заголовка.
</para>

</directive>


<directive name="proxy_read_timeout">
<syntax><value>время</value></syntax>
<default>60s</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт таймаут при чтении ответа проксированного сервера.
Таймаут устанавливается не на всю передачу ответа,
а только между двумя операциями чтения.
Если по истечении этого времени проксируемый сервер ничего не передаст,
то nginx закрывает соединение.
</para>

</directive>


<directive name="proxy_redirect">
<syntax><literal>default</literal></syntax>
<syntax><literal>off</literal></syntax>
<syntax><value>перенаправление</value> <value>замена</value></syntax>
<default>default</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт текст, который нужно изменить в полях заголовка
<header>Location</header> и <header>Refresh</header> в ответе
проксируемого сервера.
Предположим, проксируемый сервер вернул поле заголовка
“<literal>Location: http://localhost:8000/two/some/uri/</literal>”.
Директива
<example>
    proxy_redirect http://localhost:8000/two/ http://frontend/one/;
</example>
перепишет эту строку в виде
“<literal>Location: http://frontend/one/some/uri/</literal>”.
</para>

<para>
В заменяемой строке можно не указывать имя сервера:
<example>
    proxy_redirect http://localhost:8000/two/ /;
</example>
тогда будет подставлено основное имя сервера и порт, если он отличен от 80.
</para>

<para>
Изменение по умолчанию, задаваемое значением <literal>default</literal>,
использует параметры директив
<link doc="ngx_http_core_module.xml" id="location"/> и
<link id="proxy_pass"/>.
Поэтому две нижеприведённые конфигурации одинаковы:
<example>
location /one/ {
    proxy_pass     http://upstream:port/two/;
    proxy_redirect default;
</example>

<example>
location /one/ {
    proxy_pass     http://upstream:port/two/;
    proxy_redirect http://upstream:port/two/ /one/;
</example>
Значение <literal>default</literal> недопустимо, если в <link id="proxy_pass"/>
используются переменные.
</para>

<para>
В заменяемой строке можно использовать переменные:
<example>
    proxy_redirect http://localhost:8000/ http://$host:$server_port/;
</example>
</para>

<para>
В перенаправлении тоже можно использовать (1.1.11) переменные:
<example>
    proxy_redirect http://$proxy_host:8000/ /;
</example>
</para>

<para>
Директиву также можно задать (1.1.11) при помощи регулярных выражений.
При этом <value>перенаправление</value> должно начинаться либо с символа
“<literal>~</literal>”, если при сравнении следует учитывать регистр символов,
либо с символов “<literal>~*</literal>”, если регистр символов учитывать
не нужно.
Регулярное выражение может содержать именованные и позиционные выделения,
а <value>замена</value> ссылаться на них:
<example>
    proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2;
    proxy_redirect ~*/user/([^/]+)/(.+)$      http://$1.example.com/$2;
</example>
</para>

<para>
Директив может быть несколько:
<example>
    proxy_redirect default;
    proxy_redirect http://localhost:8000/  /;
    proxy_redirect http://www.example.com/ /;
</example>
</para>

<para>
Значение <literal>off</literal> запрещает все директивы
<literal>proxy_redirect</literal>
на данном уровне:
<example>
    proxy_redirect off;
    proxy_redirect default;
    proxy_redirect http://localhost:8000/  /;
    proxy_redirect http://www.example.com/ /;
</example>
</para>

<para>
С помощью этой директивы можно также добавлять имя хоста к относительным
перенаправлениям, выдаваемым проксируемым сервером:
<example>
    proxy_redirect / /;
</example>
</para>

</directive>


<directive name="proxy_send_timeout">
<syntax><value>время</value></syntax>
<default>60</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт таймаут при передаче запроса проксированному серверу.
Таймаут устанавливается не на всю передачу запроса,
а только между двумя операциями записи.
Если по истечении этого времени проксируемый сервер не примет новых данных,
то nginx закрывает соединение.
</para>

</directive>


<directive name="proxy_set_header">
<syntax><value>поле</value> <value>значение</value></syntax>
<default>Host $proxy_host</default>
<default>Connection close</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Позволяет переопределять или добавлять поля заголовка запроса,
передаваемые проксируемому серверу.
В качестве значения можно использовать текст, переменные и их комбинации.
Директивы наследуются с предыдущего уровня при условии, что на данном
уровне не описаны свои директивы <literal>proxy_set_header</literal>.
По умолчанию переопределяются только два поля:
<example>
proxy_set_header Host       $proxy_host;
proxy_set_header Connection close;
</example>
</para>

<para>
Неизменённое поле заголовка запроса <header>Host</header> можно передать так:
<example>
proxy_set_header Host       $http_host;
</example>
</para>

<para>
Однако, если это поле отсутствует в заголовке запроса клиента, то ничего
передаваться не будет. В этом случае лучше воспользоваться переменной
<var>$host</var> - её значение равно имени сервера в поле <header>Host</header>
заголовка запроса, или же основному имени сервера, если поля нет:
<example>
proxy_set_header Host       $host;
</example>
</para>

<para>
Кроме того, можно передать имя сервера вместе с портом проксируемого сервера:
<example>
proxy_set_header Host       $host:$proxy_port;
</example>
</para>

<para>
Если значение поля заголовка — пустая строка, то поле вообще
не будет передаваться проксируемому серверу:
<example>
proxy_set_header Accept-Encoding "";
</example>
</para>

</directive>


<directive name="proxy_ssl_session_reuse">
<syntax><literal>on</literal> | <literal>off</literal></syntax>
<default>on</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Определяет, использовать ли повторно SSL-сессии при
работе с проксированным сервером. Если в логах появляются ошибки
“<literal>SSL3_GET_FINISHED:digest check failed</literal>”,
то можно попробовать выключить
повторное использование сессий.
</para>

</directive>


<directive name="proxy_store">
<syntax>
    <literal>on</literal> |
    <literal>off</literal> |
    <value>строка</value></syntax>
<default>off</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Разрешает сохранение на диск файлов.
Параметр <literal>on</literal> сохраняет файлы в соответствии с путями,
указанными в директивах
<link doc="ngx_http_core_module.xml" id="alias"/> или
<link doc="ngx_http_core_module.xml" id="root"/>.
Параметр <literal>off</literal> запрещает сохранение файлов.
Кроме того, имя файла можно задать явно с помощью строки с переменными:
<example>
proxy_store /data/www$original_uri;
</example>
</para>

<para>
Время изменения файлов выставляется согласно полученному полю
<header>Last-Modified</header> в заголовке ответа.
Ответ записывается во временный файл, а потом этот файл переименовывается.
Начиная с версии 0.8.9, временный файл и постоянное место хранения ответа
могут располагаться на разных файловых системах, но нужно учитывать,
что в этом случае вместо дешёвой операции переименовывания в пределах
одной файловой системы файл копируется с одной файловой системы на другую.
Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой
системе, что и каталог с временными файлами, задаваемый директивой
<link id="proxy_temp_path"/> для данного location.
</para>

<para>
Директиву можно использовать для создания локальных копий статических
неизменяемых файлов, например, так:
<example>
location /images/ {
    root                   /data/www;
    open_file_cache_errors off;
    error_page             404 = /fetch$uri;
}

location /fetch/ {
    internal;

    proxy_pass             http://backend/;
    proxy_store            on;
    proxy_store_access     user:rw group:rw all:r;
    proxy_temp_path        /data/temp;

    alias                  /data/www/;
}
</example>
</para>

<para>
или так:
<example>
location /images/ {
    root               /data/www;
    error_page         404 = @fetch;
}

location @fetch {
    internal;

    proxy_pass         http://backend;
    proxy_store        on;
    proxy_store_access user:rw group:rw all:r;
    proxy_temp_path    /data/temp;

    root               /data/www;
}
</example>
</para>

</directive>


<directive name="proxy_store_access">
<syntax><value>пользователи</value>:<value>права</value> ...</syntax>
<default>user:rw</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт права доступа для создаваемых файлов и каталогов, например,
<example>
proxy_store_access user:rw group:rw all:r;
</example>
</para>

<para>
Если заданы какие-либо права для <literal>group</literal> или
<literal>all</literal>, то права для <literal>user</literal>
указывать необязательно:
<example>
proxy_store_access group:rw all:r;
</example>
</para>

</directive>


<directive name="proxy_temp_path">
<syntax>
    <value>путь</value>
    [<value>уровень1</value>
    [<value>уровень2</value>
    [<value>уровень3</value>]]]</syntax>
<default>proxy_temp</default>
<context>http</context>
<context>server</context>
<context>location</context>

<para>
Задаёт имя каталога для хранения временных файлов,
полученных от другого сервера.
В каталоге может использоваться иерархия подкаталогов до трёх уровней.
Например, при такой конфигурации
<example>
proxy_temp_path /spool/nginx/proxy_temp 1 2;
</example>
временный файл будет следующего вида:
<example>
/spool/nginx/proxy_temp/7/45/00000123457
</example>
</para>

</directive>

</section>


<section id="variables" name="Встроенные переменные">

<para>
В модуле <literal>ngx_http_proxy_module</literal> есть встроенные переменные,
которые можно использовать для формирования заголовков с помощью директивы
<link id="proxy_set_header"/>:
<list type="tag">

<tag-name><var>$proxy_host</var></tag-name>
<tag-desc>имя проксируемого хоста и порт;</tag-desc>

<tag-name><var>$proxy_port</var></tag-name>
<tag-desc>порт проксируемого хоста;</tag-desc>

<tag-name><var>$proxy_add_x_forwarded_for</var></tag-name>
<tag-desc>поле заголовка запроса клиента <header>X-Forwarded-For</header>
и добавленная к нему через запятую переменная <var>$remote_addr</var>.
Если же поля <header>X-Forwarded-For</header> в заголовке запроса клиента нет,
то переменная <var>$proxy_add_x_forwarded_for</var>
равна переменной <var>$remote_addr</var>.</tag-desc>
</list>
</para>

</section>

</module>