# Proxy Позволяет передавать запросы другому (проксируемому) серверу. ## Пример конфигурации ```nginx location / { proxy_pass http://localhost:8000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_cache cache_zone; proxy_cache_valid 200 302 10m; proxy_cache_valid 404 1m; } ``` ## Директивы ### proxy_bind | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_bind` адрес [`transparent`] | `off`; | |------------------------------------------------------------------------------------------|-----------------------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает локальный IP-адрес с необязательным портом, который будет использоваться в исходящих соединениях с проксируемым сервером. В значении параметра допустимо использование переменных. Специальное значение `off` отменяет действие унаследованной с предыдущего уровня конфигурации директивы proxy_bind, позволяя системе самостоятельно выбирать локальный IP-адрес и порт. Параметр `transparent` позволяет задать нелокальный IP-aдрес, который будет использоваться в исходящих соединениях с проксируемым сервером, например, реальный IP-адрес клиента: ```nginx proxy_bind $remote_addr transparent; ``` Для работы параметра обычно требуется запустить рабочие процессы Angie с привилегиями [суперпользователя](https://angie.software//angie/docs/configuration/modules/core.md#user). В Linux это не требуется, так как если указан параметр transparent, то рабочие процессы наследуют capability CAP_NET_RAW из главного процесса. #### NOTE Необходимо настроить таблицу маршрутизации ядра для перехвата сетевого трафика с проксируемого сервера. ### proxy_buffer_size | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_buffer_size` размер; | |------------------------------------------------------------------------------------------|-------------------------------| | По умолчанию | `proxy_buffer_size 4k|8k;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает размер буфера, в который будет читаться первая часть ответа, получаемого от проксируемого сервера. В этой части ответа обычно находится небольшой заголовок ответа. По умолчанию размер одного буфера равен размеру страницы памяти. В зависимости от платформы это или 4K, или 8K, однако его можно сделать меньше. ### proxy_buffering | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_buffering` `on` | `off`; | |------------------------------------------------------------------------------------------|-----------------------------------| | По умолчанию | `proxy_buffering on;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Разрешает или запрещает буферизацию ответов от проксируемого сервера. | `on` | Angie принимает ответ проксируемого сервера как можно быстрее, сохраняя
его в буферы, заданные директивами [proxy_buffer_size](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-buffer-size) и
[proxy_buffers](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-buffers). Отправка клиенту при этом выполняется
параллельно: заполненные буферы передаются на отправку (никто их не
удерживает), но суммарно не более значения
[proxy_busy_buffers_size](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-busy-buffers-size). Если буфер заполнен не полностью, то на
отправку он не передается, если только это не последние данные ответа.
Поэтому для моментальной передачи каждых нескольких байт режим
буферизированного чтения не подходит. Если ответ не вмещается целиком в
память, то его часть может быть записана на диск во [временный файл](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-temp-path). Запись во временные файлы контролируется директивами
[proxy_max_temp_file_size](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-max-temp-file-size) и [proxy_temp_file_write_size](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-temp-file-write-size). | |--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `off` | Ответ передается клиенту сразу же по мере его поступления. Angie работает
в цикле "чтение — отправка" и не ждет, пока буфер заполнится целиком:
например, прочитанные 10 байт из буфера 4К будут сразу отправлены
клиенту. При этом, если весь ответ умещается в буфер, Angie может
прочитать его целиком. Максимальный размер данных, который Angie может
принять от сервера за один раз, задается директивой
[proxy_buffer_size](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-buffer-size). В режиме `off` Angie не кэширует ответы и
не работает [proxy_limit_rate](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-limit-rate). | Буферизация может быть также включена или выключена путем передачи значения "yes" или "no" в поле `X-Accel-Buffering` заголовка ответа. Эту возможность можно запретить с помощью директивы [proxy_ignore_headers](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-ignore-headers). ### proxy_buffers | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_buffers` число размер; | |------------------------------------------------------------------------------------------|---------------------------------| | По умолчанию | `proxy_buffers 8 4k | 8k;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает число и размер буферов для одного соединения, в которые будет читаться ответ, получаемый от проксируемого сервера. По умолчанию размер одного буфера равен размеру страницы. В зависимости от платформы это или 4K, или 8K. ### proxy_busy_buffers_size | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_busy_buffers_size` размер; | |------------------------------------------------------------------------------------------|-------------------------------------| | По умолчанию | `proxy_busy_buffers_size 8k | 16k;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | При включенной [буферизации](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-buffering) ответов проксируемого сервера, ограничивает суммарный размер буферов, которые могут быть заняты для отправки ответа клиенту, пока ответ еще не прочитан целиком. Оставшиеся буферы тем временем могут использоваться для чтения ответа и, при необходимости, буферизации части ответа во временный файл. По умолчанию размер ограничен величиной двух буферов, заданных директивами [proxy_buffer_size](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-buffer-size) и [proxy_buffers](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-buffers). ### proxy_cache | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache` зона | `off` [`path=`путь]; | |------------------------------------------------------------------------------------------|---------------------------------------------| | По умолчанию | `proxy_cache off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает зону разделяемой памяти для кэширования. Одну и ту же зону можно использовать в нескольких местах конфигурации. В значении параметра допускаются переменные. | `off` | запрещает кэширование, унаследованное с предыдущего уровня конфигурации. | |---------|----------------------------------------------------------------------------| В Angie PRO можно указать несколько директив [proxy_cache_path](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache-path), использующих одно и то же значение `keys_zone`, чтобы включить шардинг кэша. При этом следует задать параметр `path` директивы [proxy_cache](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache), использующей это значение `keys_zone`: | `path=`путь | Значение вычисляется в момент *кэширования* ответа от бэкенда
и предполагает использование переменных, в том числе содержащих
информацию из ответа.

Если ответ берется из кэша, то путь не вычисляется заново;
таким образом, кэшированный ответ сохраняет изначальный путь,
пока не будет удален из кэша. | |---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| Это позволяет выбирать нужный путь кэша, применяя директивы [map](https://angie.software//angie/docs/configuration/modules/http/http_map.md#id3) или скрипты к ответам от бэкенда. Пример для `Content-Type`: ```nginx proxy_cache_path /cache/one keys_zone=zone:10m; proxy_cache_path /cache/two keys_zone=zone; map $upstream_http_content_type $cache { ~^text/ one; default two; } server { ... location / { proxy_pass http://backend; proxy_cache zone path=/cache/$cache; proxy_cache_valid 200 10m; } } ``` Здесь есть два пути кэша и отображение переменной, чтобы их различать. Если `Content-Type` начинается с `text/`, будет выбран первый путь, иначе — второй. #### NOTE При использовании [proxy_cache](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache) обычно необходимо также задать директиву [proxy_cache_valid](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache-valid), чтобы явно указать время действия кэшированных ответов. Если она не задана, Angie не использует значения по умолчанию, а определяет время хранения ответа в кэше на основе HTTP-заголовков ответа от сервера в следующем порядке приоритета: 1. Заголовок `X-Accel-Expires` (наивысший приоритет). 2. Заголовок `Cache-Control` с параметрами `max-age` или `s-maxage`. 3. Заголовок `Expires`. Если ни один заголовок не содержит допустимого значения или их нет вовсе, ответ не будет кэшироваться, так как определить срок его действия нельзя. ### proxy_cache_background_update | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_background_update` `on` | `off`; | |------------------------------------------------------------------------------------------|-------------------------------------------------| | По умолчанию | `proxy_cache_background_update off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Позволяет запустить фоновый подзапрос для обновления просроченного элемента кэша, в то время как клиенту возвращается устаревший кэшированный ответ. #### WARNING Использование устаревшего кэшированного ответа в момент его обновления должно быть [разрешено](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache-use-stale-updating). ### proxy_cache_bypass | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_bypass` ...; | |------------------------------------------------------------------------------------------|-----------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает условия, при которых ответ не будет браться из кэша. Если значение хотя бы одного из строковых параметров непустое и не равно "0", то ответ не берется из кэша: ```nginx proxy_cache_bypass $cookie_nocache $arg_nocache$arg_comment; proxy_cache_bypass $http_pragma $http_authorization; ``` Можно использовать совместно с директивой [proxy_no_cache](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-no-cache). ### proxy_cache_convert_head | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_convert_head` `on` | `off`; | |------------------------------------------------------------------------------------------|--------------------------------------------| | По умолчанию | `proxy_cache_convert_head on;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Разрешает или запрещает преобразование метода "HEAD" в "GET" для кэширования. Если преобразование выключено, то необходимо, чтобы [ключ кэширования](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache-key) включал в себя [$request_method](https://angie.software//angie/docs/configuration/modules/http/index.md#v-request-method). ### proxy_cache_key | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_key` строка; | |------------------------------------------------------------------------------------------|---------------------------------------------------| | По умолчанию | `proxy_cache_key $scheme$proxy_host$request_uri;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает ключ для кэширования, например, ```nginx proxy_cache_key "$host$request_uri $cookie_user"; ``` По умолчанию значение директивы близко к строке ```nginx proxy_cache_key $scheme$proxy_host$uri$is_args$args; ``` ### proxy_cache_lock | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_lock` `on` | `off`; | |------------------------------------------------------------------------------------------|------------------------------------| | По умолчанию | `proxy_cache_lock off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Если включено, одновременно только одному запросу будет позволено заполнить новый элемент кэша, идентифицируемый согласно директиве [proxy_cache_key](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache-key), передав запрос на проксируемый сервер. Остальные запросы этого же элемента будут либо ожидать появления ответа в кэше, либо освобождения блокировки этого элемента, в течение времени, заданного директивой [proxy_cache_lock_timeout](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache-lock-timeout). ### proxy_cache_lock_age | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_lock_age` время; | |------------------------------------------------------------------------------------------|---------------------------------| | По умолчанию | `proxy_cache_lock_age 5s;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Если последний запрос, переданный на проксируемый сервер для заполнения нового элемента кэша, не завершился за указанное время, на проксируемый сервер может быть передан еще один запрос. ### proxy_cache_lock_timeout | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_lock_timeout` время; | |------------------------------------------------------------------------------------------|-------------------------------------| | По умолчанию | `proxy_cache_lock_timeout 5s;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает таймаут для [proxy_cache_lock](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache-lock). По истечении указанного времени запрос будет передан на проксируемый сервер, однако ответ не будет кэширован. ### proxy_cache_max_range_offset | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_max_range_offset` число; | |------------------------------------------------------------------------------------------|-----------------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает смещение в байтах для запросов с указанием диапазона запрашиваемых байт (byte-range requests). Если диапазон находится за указанным смещением, range-запрос будет передан на проксируемый сервер и ответ не будет кэширован. ### proxy_cache_methods | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_methods` `GET` | `HEAD` | `POST` ...; | |------------------------------------------------------------------------------------------|------------------------------------------------------| | По умолчанию | `proxy_cache_methods GET HEAD;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Если метод запроса клиента указан в этой директиве, то ответ будет кэширован. Методы "GET" и "HEAD" всегда добавляются в список, но тем не менее рекомендуется перечислять их явно. См. также директиву [proxy_no_cache](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-no-cache). ### proxy_cache_min_uses | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_min_uses` число; | |------------------------------------------------------------------------------------------|---------------------------------| | По умолчанию | `proxy_cache_min_uses 1;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает число запросов, после которого ответ будет кэширован. #### WARNING Метаданные кэша хранятся в разделяемой памяти. Ручное удаление файлов кэша не сбрасывает счетчики и может привести к непредсказуемому поведению. Для полного сброса остановите сервер, удалите директорию кэша и запустите снова. #### NOTE Сторонние модули очистки кэша (например, [Cache Purge](https://angie.software//angie/docs/installation/external-modules/cache-purge.md#external-cache-purge)) удаляют только файлы, но не сбрасывают счетчик proxy_cache_min_uses. Директива предназначена для защиты кэша от загрязнения редкими запросами, и сброс счетчика при очистке может негативно повлиять на производительность. ### proxy_cache_path | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_path` путь [`levels=`уровни] [`use_temp_path=``on` | `off`] `keys_zone=`имя:размер[:`file=`файл] [`inactive=`время] [`max_size=`размер] [`min_free=`размер] [`manager_files=`число] [`manager_sleep=`время] [`manager_threshold=`время] [`loader_files=`число] [`loader_sleep=`время] [`loader_threshold=`время]; | |------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http | Задает путь и другие параметры кэша. Данные кэша хранятся в файлах. Именем файла в кэше является результат функции MD5 от [ключа кэширования](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache-key). | `levels` | задает уровни иерархии кэша: можно задать от 1 до 3 уровней, на каждом уровне допускаются значения 1 или 2. | |------------|---------------------------------------------------------------------------------------------------------------| Например, при использовании ```nginx proxy_cache_path /data/angie/cache levels=1:2 keys_zone=one:10m; ``` имена файлов в кэше будут такого вида: ```nginx /data/angie/cache/c/29/b7f54b2df7773722d382f4809d65029c ``` Кэшируемый ответ сначала записывается во временный файл, а потом этот файл переименовывается. Временные файлы и кэш могут располагаться на разных файловых системах. Однако нужно учитывать, что в этом случае вместо дешевой операции переименовывания в пределах одной файловой системы файл копируется с одной файловой системы на другую. Поэтому лучше, если кэш будет находиться на той же файловой системе, что и каталог с временными файлами. | `use_temp_path=on` | `off` | определяет каталог, который будет использоваться для временных файлов | |------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `on` | Если параметр не задан или установлен в значение `on`, будет использоваться каталог, задаваемый директивой [proxy_temp_path](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-temp-path) для данного location | | `off` | временные файлы будут располагаться непосредственно в каталоге кэша | | `keys_zone` | Задает имя и размер зоны разделяемой памяти для хранения всех активных ключей и информации о данных. Метаданные кэша хранятся в разделяемой памяти.

Зоны размером в 1 мегабайт достаточно для хранения около 8000 ключей.

Когда с `keys_zone` задан необязательный файл,
Angie сбрасывает содержимое этой зоны на диск
при завершении работы основного процесса
и пытается восстановить ее по тому же адресу памяти
при следующем [запуске](https://angie.software//angie/docs/configuration/runtime.md#runtime)
или после [обновления бинарных файлов](https://angie.software//angie/docs/configuration/runtime.md#service-upgrade),
чтобы обеспечить более надежную сохраняемость данных
и сократить время загрузки кэша.

Если восстановление области невозможно из-за изменения ее размера,
несовместимости версий бинарных файлов или по другим причинам,
Angie запишет в журнал предупреждение (`failed to restore zone at address`)
и не будет использовать механизм восстановления зоны.
Вместо этого несовместимый файл будет переименован в `.old`;
вы можете либо удалить его,
либо восстановить его имя и вернуть Angie к конфигурации и версии,
в которых этот файл был изначально создан.

#### WARNING
Убедитесь, что путь к файлу указан правильно
и имеет необходимые права доступа для использования Angie,
а также защищен от несанкционированного доступа;
относительные пути основаны на [префиксе](https://angie.software//angie/docs/installation/sourcebuild.md#paths). | | `inactive` | Если к данным кэша не обращаются в течение времени, заданного этим параметром, то данные удаляются, независимо от их свежести.

По умолчанию `inactive` равен 10 минутам. | Специальный процесс **менеджера кэша** следит за максимальным размером кэша, а также за минимальным объемом свободного места на файловой системе с кэшем, и удаляет наименее востребованные данные при превышении максимального размера кэша или недостаточном объеме свободного места. Удаление данных происходит итерациями. | `max_size` | максимальное пороговое значение размера кэша | |---------------------|---------------------------------------------------------------------------------------------------------| | `min_free` | минимальное пороговое значение объема свободного места на файловой системе с кэшем | | `manager_files` | максимальное количество удаляемых элементов кэша за одну итерацию

По умолчанию: `100`. | | `manager_threshold` | ограничивает время работы одной итерации

По умолчанию: `200` миллисекунд. | | `manager_sleep` | время, в течение которого выдерживается пауза между итерациями

По умолчанию: `50` миллисекунд. | Через минуту после запуска Angie активируется специальный процесс **загрузчика кэша**. Он сканирует файловую систему в поисках ранее закэшированных данных и загружает эту информацию в область кэша. Этот процесс выполняется итеративно; каждая итерация обрабатывает ограниченное количество элементов, заданное параметром `loader_files`, следит за тем, чтобы не превышать `loader_threshold`, затем делает короткую паузу, заданную `loader_sleep`, перед переходом к следующей партии. Итерации продолжаются до тех пор, пока загрузчик не обработает все существующие записи кэша на диске: | `loader_files` | максимальное количество элементов кэша к загрузке в одну итерацию

По умолчанию: `100` | |--------------------|--------------------------------------------------------------------------------------------------------| | `loader_threshold` | ограничивает время работы одной итерации

По умолчанию: `200` миллисекунд | | `loader_sleep` | время, в течение которого выдерживается пауза между итерациями

По умолчанию: `50` миллисекунд | #### NOTE Указание файла для параметра `keys_zone` не влияет на работу загрузчика кэша. ### proxy_cache_revalidate | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_revalidate` `on` | `off`; | |------------------------------------------------------------------------------------------|------------------------------------------| | По умолчанию | `proxy_cache_revalidate off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Разрешает ревалидацию просроченных элементов кэша при помощи условных запросов с полями заголовка `If-Modified-Since` и `If-None-Match` . ### proxy_cache_use_stale | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_use_stale` `error` | `timeout` | `invalid_header` | `updating` | `http_500` | `http_502` | `http_503` | `http_504` | `http_403` | `http_404` | `http_429` | `off` ...; | |------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | По умолчанию | `proxy_cache_use_stale off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Определяет, в каких случаях можно использовать устаревший кэшированный ответ. Параметры директивы совпадают с параметрами директивы [proxy_next_upstream](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-next-upstream). | `error` | Позволяет использовать устаревший кэшированный ответ при невозможности выбора проксированного сервера для обработки запроса. | |------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `updating` | Дополнительный параметр, разрешает использовать устаревший кэшированный ответ, если на данный момент он уже обновляется. Это позволяет минимизировать число обращений к проксированным серверам при обновлении кэшированных данных. | Использование устаревшего кэшированного ответа может также быть разрешено непосредственно в заголовке ответа на определенное количество секунд после того, как ответ устарел: * Расширение [stale-while-revalidate](https://datatracker.ietf.org/doc/html/rfc5861#section-3) поля заголовка `Cache-Control` разрешает использовать устаревший кэшированный ответ, если на данный момент он уже обновляется. * Расширение [stale-if-error](https://datatracker.ietf.org/doc/html/rfc5861#section-4) поля заголовка `Cache-Control` разрешает использовать устаревший кэшированный ответ в случае ошибки. #### NOTE Такой способ менее приоритетен, чем задание параметров директивы. Чтобы минимизировать число обращений к проксированным серверам при заполнении нового элемента кэша, можно воспользоваться директивой [proxy_cache_lock](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache-lock). ### proxy_cache_valid | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cache_valid` [код ...] время; | |------------------------------------------------------------------------------------------|----------------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает время кэширования для разных кодов ответа. Например, директивы ```nginx proxy_cache_valid 200 302 10m; proxy_cache_valid 404 1m; ``` задают время кэширования 10 минут для ответов с кодами 200 и 302 и 1 минуту для ответов с кодом 404. Если указано только время кэширования, ```nginx proxy_cache_valid 5m; ``` то кэшируются только ответы 200, 301 и 302. Кроме того, можно кэшировать любые ответы с помощью параметра `any`: ```nginx proxy_cache_valid 200 302 10m; proxy_cache_valid 301 1h; proxy_cache_valid any 1m; ``` #### NOTE Параметры кэширования могут также быть заданы непосредственно в заголовке ответа. Такой способ приоритетнее, чем задание времени кэширования с помощью директивы. * Поле заголовка `X-Accel-Expires` задает время кэширования ответа в секундах. Значение 0 запрещает кэшировать ответ. Если значение начинается с префикса @, оно задает абсолютное время в секундах с начала эпохи, до которого ответ может быть кэширован. * Если в заголовке нет поля `X-Accel-Expires`, параметры кэширования определяются по полям заголовка `Expires` или `Cache-Control`. * Ответ, в заголовке которого есть поле `Set-Cookie`, не будет кэшироваться. * Ответ, в заголовке которого есть поле `Vary` со специальным значением "\*", не будет кэшироваться. Ответ, в заголовке которого есть поле `Vary` с другим значением, будет кэширован с учетом соответствующих полей заголовка запроса. Обработка одного или более из этих полей заголовка может быть отключена при помощи директивы [proxy_ignore_headers](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-ignore-headers). ### proxy_connect_timeout | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_connect_timeout` время; | |------------------------------------------------------------------------------------------|----------------------------------| | По умолчанию | `proxy_connect_timeout 60s;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает таймаут для установления соединения с проксированным сервером. Необходимо иметь в виду, что этот таймаут обычно не может превышать 75 секунд. ### proxy_connection_drop | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_connection_drop` время | `on` | `off`; | |------------------------------------------------------------------------------------------|-------------------------------------------------| | По умолчанию | `proxy_connection_drop off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Настраивает завершение всех соединений с проксируемым сервером, если он был удален из группы или помечен как постоянно недоступный в результате процесса [reresolve](https://angie.software//angie/docs/configuration/modules/http/http_upstream.md#reresolve) или [команды API](https://angie.software//angie/docs/configuration/modules/http/http_api.md#api-config-methods) `DELETE`. Соединение завершается, когда обрабатывается следующее событие чтения или записи для клиента или проксируемого сервера. Установка времени включает [таймаут](https://angie.software//angie/docs/configuration/configfile.md#syntax) до завершения соединения; при выборе значения `on` соединения завершаются немедленно. ### proxy_cookie_domain | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cookie_domain` `off`;

`proxy_cookie_domain` домен замена; | |------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------| | По умолчанию | `proxy_cookie_domain off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает текст, который нужно изменить в атрибуте domain полей `Set-Cookie` заголовка ответа проксируемого сервера. Предположим, проксируемый сервер вернул поле заголовка `Set-Cookie` с атрибутом "domain=localhost". Директива ```nginx proxy_cookie_domain localhost example.org; ``` перепишет данный атрибут в виде "domain=example.org". Точка в начале строк домен и замена, а равно как и в атрибуте domain игнорируется. Регистр значения не имеет. В строках домен и замена можно использовать переменные: ```nginx proxy_cookie_domain www.$host $host; ``` Директиву также можно задать при помощи регулярных выражений. При этом домен должен начинаться с символа "~". Регулярное выражение может содержать именованные и позиционные группы захвата, а замена ссылаться на них: ```nginx proxy_cookie_domain ~\.(?P[-0-9a-z]+\.[a-z]+)$ $sl_domain; ``` На одном уровне может быть указано несколько директив proxy_cookie_domain: ```nginx proxy_cookie_domain localhost example.org; proxy_cookie_domain ~\.([a-z]+\.[a-z]+)$ $1; ``` Если к cookie могут быть применены несколько директив, будет выбрана первая из них. Параметр `off` отменяет действие унаследованных с предыдущего уровня конфигурации директив proxy_cookie_domain. ### proxy_cookie_flags | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cookie_flags` `off` | cookie [флаг ...]; | |------------------------------------------------------------------------------------------|---------------------------------------------------| | По умолчанию | `proxy_cookie_flags off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает один или несколько флагов для cookie. В качестве cookie можно использовать текст, переменные и их комбинации. В качестве флага можно использовать текст, переменные и их комбинации. Параметры secure, httponly, samesite=strict, samesite=lax, samesite=none добавляют соответствующие флаги. Параметры nosecure, nohttponly, nosamesite удаляют соответствующие флаги. Cookie также можно задать при помощи регулярных выражений. При этом cookie должен начинаться с символа "~". На одном уровне конфигурации может быть указано несколько директив proxy_cookie_flags: ```nginx proxy_cookie_flags one httponly; proxy_cookie_flags ~ nosecure samesite=strict; ``` Если к cookie могут быть применены несколько директив, будет выбрана первая из них. В данном примере флаг httponly добавляется к cookie one, для остальных cookie добавляется флаг samesite=strict и удаляется флаг secure. Параметр `off` отменяет действие всех директив proxy_cookie_flags на данном уровне. ### proxy_cookie_path | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_cookie_path` `off`;

`proxy_cookie_path` путь замена; | |------------------------------------------------------------------------------------------|------------------------------------------------------------------------| | По умолчанию | `proxy_cookie_path off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает текст, который нужно изменить в атрибуте path полей `Set-Cookie` заголовка ответа проксируемого сервера. Предположим, проксируемый сервер вернул поле заголовка `Set-Cookie` с атрибутом "path=/two/some/uri/". Директива ```nginx proxy_cookie_path /two/ /; ``` перепишет данный атрибут в виде "path=/some/uri/". В строках путь и замена можно использовать переменные: ```nginx proxy_cookie_path $uri /some$uri; ``` Директиву также можно задать при помощи регулярных выражений. При этом путь должен начинаться либо с символа "~", если при сравнении следует учитывать регистр символов, либо с символов "~\*", если регистр символов учитывать не нужно. Регулярное выражение может содержать именованные и позиционные группы захвата, а замена ссылаться на них: ```nginx proxy_cookie_path ~*^/user/([^/]+) /u/$1; ``` На одном уровне может быть указано несколько директив proxy_cookie_path: ```nginx proxy_cookie_path /one/ /; proxy_cookie_path / /two/; ``` Если к cookie могут быть применены несколько директив, будет выбрана первая из них. Параметр `off` отменяет действие унаследованных с предыдущего уровня конфигурации директив proxy_cookie_path. ### proxy_force_ranges | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_force_ranges` `on` | `off`; | |------------------------------------------------------------------------------------------|--------------------------------------| | По умолчанию | `proxy_force_ranges off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Включает поддержку диапазонов запрашиваемых байт (byte-range) для кэшированных и некэшированных ответов проксируемого сервера вне зависимости от наличия поля `Accept-Ranges` в заголовках этих ответов. ### proxy_headers_hash_bucket_size | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_headers_hash_bucket_size` размер; | |------------------------------------------------------------------------------------------|--------------------------------------------| | По умолчанию | `proxy_headers_hash_bucket_size 64;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает размер корзины для хэш-таблиц, используемых директивами [proxy_hide_header](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-hide-header) и [proxy_set_header](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-set-header). Подробнее настройка хэш-таблиц обсуждается [отдельно](https://angie.software//angie/docs/configuration/configfile.md#configure-hashes). ### proxy_headers_hash_max_size | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_headers_hash_max_size` размер; | |------------------------------------------------------------------------------------------|-----------------------------------------| | По умолчанию | `proxy_headers_hash_max_size 512;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает максимальный размер хэш-таблиц, используемых директивами [proxy_hide_header](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-hide-header) и [proxy_set_header](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-set-header). Подробнее настройка хэш-таблиц обсуждается [отдельно](https://angie.software//angie/docs/configuration/configfile.md#configure-hashes). ### proxy_hide_header | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_hide_header` поле; | |------------------------------------------------------------------------------------------|-----------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | По умолчанию Angie не передает клиенту поля заголовка `Date`, `Server`, `X-Pad` и `X-Accel-...` из ответа проксированного сервера. Директива proxy_hide_header задает дополнительные поля, которые не будут передаваться. Если же передачу полей нужно разрешить, можно воспользоваться директивой [proxy_pass_header](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-pass-header). ### proxy_http_version | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_http_version` `1.0` | `1.1` | `3`; | |------------------------------------------------------------------------------------------|-----------------------------------------------------| | По умолчанию | `proxy_http_version 1.0;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location, if в location, limit_except | Задает версию протокола HTTP для проксирования. По умолчанию используется версия 1.0. Для работы [постоянных соединений](https://angie.software//angie/docs/configuration/modules/http/http_upstream.md#u-keepalive) рекомендуется версия 1.1 или выше. ### proxy_http3_hq | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_http3_hq` `on` | `off`; | |------------------------------------------------------------------------------------------|----------------------------------| | По умолчанию | `proxy_http3_hq off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server | Отключает или включает особый режим cогласования `hq-interop`, используемый в [функциональных тестах](https://github.com/marten-seemann/quic-interop-runner) [QUIC](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-http-version), на которые полагается Angie. #### WARNING Включайте этот режим только для запуска специализированных тестов, которым в явной форме необходим данный режим. ### proxy_http3_max_concurrent_streams | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_http3_max_concurrent_streams` число; | |------------------------------------------------------------------------------------------|-----------------------------------------------| | По умолчанию | `proxy_http3_max_concurrent_streams 128;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server | Инициализирует настройки HTTP/3 и QUIC, а также задает максимальное число параллельных HTTP/3-потоков в [соединении](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-http-version). Требует включения [постоянных соединений](https://angie.software//angie/docs/configuration/modules/http/http_upstream.md#u-keepalive). ### proxy_http3_max_table_capacity | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_http3_max_table_capacity` число; | |------------------------------------------------------------------------------------------|-------------------------------------------| | Значение по умолчанию | `proxy_http3_max_table_capacity 4096;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Определяет емкость [динамической таблицы](https://www.ietf.org/archive/id/draft-ietf-quic-qpack-20.html#name-dynamic-table) для прокси-соединений. #### NOTE Похожая директива [http3_max_table_capacity](https://angie.software//angie/docs/configuration/modules/http/http_v3.md#http3-max-table-capacity) задает это значение для серверных соединений. Чтобы избежать ошибок, использование динамической таблицы отключается при включенном кэшировании в режиме проксирования. ### proxy_http3_stream_buffer_size | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_http3_stream_buffer_size` размер; | |------------------------------------------------------------------------------------------|--------------------------------------------| | По умолчанию | `proxy_http3_stream_buffer_size 64k;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server | Задает [размер](https://angie.software//angie/docs/configuration/configfile.md#syntax) буфера, используемого для чтения и записи [QUIC-потоков](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-http-version). ### proxy_ignore_client_abort | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ignore_client_abort` `on` | `off`; | |------------------------------------------------------------------------------------------|---------------------------------------------| | По умолчанию | `proxy_ignore_client_abort off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Определяет, закрывать ли соединение с проксируемым сервером в случае, если клиент закрыл соединение, не дождавшись ответа. ### proxy_ignore_headers | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ignore_headers` поле ...; | |------------------------------------------------------------------------------------------|------------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Запрещает обработку некоторых полей заголовка из ответа проксированного сервера. В директиве можно указать поля `X-Accel-Redirect`, `X-Accel-Expires`, `X-Accel-Limit-Rate`, `X-Accel-Buffering`, `X-Accel-Charset`, `Expires`, `Cache-Control`, `Set-Cookie` и `Vary`. Если не запрещено, обработка этих полей заголовка заключается в следующем: * `X-Accel-Expires`, `Expires`, `Cache-Control`, `Set-Cookie` и `Vary` задают [параметры кэширования](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache-valid) ответа; * `X-Accel-Redirect` производит [внутреннее перенаправление](https://angie.software//angie/docs/configuration/modules/http/index.md#internal) на указанный URI; * `X-Accel-Limit-Rate` задает [ограничение скорости](https://angie.software//angie/docs/configuration/modules/http/index.md#limit-rate) передачи ответа клиенту; * `X-Accel-Buffering` включает или выключает [буферизацию](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-buffering) ответа; * `X-Accel-Charset` задает желаемую [кодировку](https://angie.software//angie/docs/configuration/modules/http/http_charset.md#id3) ответа. ### proxy_intercept_errors | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_intercept_errors` `on` | `off`; | |------------------------------------------------------------------------------------------|------------------------------------------| | По умолчанию | `proxy_intercept_errors off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Определяет, передавать ли клиенту проксированные ответы с кодом больше либо равным 300, или же перехватывать их и перенаправлять на обработку Angie с помощью директивы [error_page](https://angie.software//angie/docs/configuration/modules/http/index.md#error-page). ### proxy_limit_rate | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_limit_rate` скорость; | |------------------------------------------------------------------------------------------|--------------------------------| | По умолчанию | `proxy_limit_rate 0;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Ограничивает скорость чтения ответа от проксируемого сервера. Скорость задается в байтах в секунду; можно использовать переменные. | `0` | отключает ограничение скорости | |-------|----------------------------------| #### NOTE Ограничение устанавливается на запрос, поэтому, если Angie одновременно откроет два соединения к проксируемому серверу, суммарная скорость будет вдвое выше заданного ограничения. Ограничение работает только в случае, если включена [буферизация](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-buffering) ответов проксируемого сервера. ### proxy_max_temp_file_size | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_max_temp_file_size` размер; | |------------------------------------------------------------------------------------------|--------------------------------------| | По умолчанию | `proxy_max_temp_file_size 1024m;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Если включена [буферизация](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-buffering) ответов проксируемого сервера, и ответ не вмещается целиком в буферы, заданные директивами [proxy_buffer_size](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-buffer-size) и [proxy_buffers](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-buffers), часть ответа может быть записана во временный файл. Эта директива задает максимальный размер временного файла. Размер данных, сбрасываемых во временный файл за один раз, задается директивой [proxy_temp_file_write_size](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-temp-file-write-size). | `0` | отключает возможность буферизации ответов во временные файлы | |-------|----------------------------------------------------------------| #### NOTE Данное ограничение не распространяется на ответы, которые будут [кэшированы](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache) или сохранены [на диске](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-store). ### proxy_method | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_method` метод; | |------------------------------------------------------------------------------------------|-------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает HTTP-метод, который будет использоваться в передаваемых на проксируемый сервер запросах вместо метода из клиентского запроса. В значении параметра допустимо использование переменных. ### proxy_next_upstream | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_next_upstream` `error` | `timeout` | `invalid_header` | `http_500` | `http_502` | `http_503` | `http_504` | `http_403` | `http_404` | `http_429` | `non_idempotent` | `off` ...; | |------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | По умолчанию | `proxy_next_upstream error timeout;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Определяет, в каких случаях запрос будет передан следующему в группе [upstream](https://angie.software//angie/docs/configuration/modules/http/http_upstream.md#http-upstream) серверу: | `error` | произошла ошибка соединения с сервером, передачи ему запроса или чтения заголовка ответа сервера; | |------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `timeout` | произошел таймаут во время соединения с сервером, передачи ему запроса или чтения заголовка ответа сервера; | | `invalid_header` | сервер вернул пустой или неверный ответ; | | `http_500` | сервер вернул ответ с кодом 500; | | `http_502` | сервер вернул ответ с кодом 502; | | `http_503` | сервер вернул ответ с кодом 503; | | `http_504` | сервер вернул ответ с кодом 504; | | `http_403` | сервер вернул ответ с кодом 403; | | `http_404` | сервер вернул ответ с кодом 404; | | `http_429` | сервер вернул ответ с кодом 429; | | `non_idempotent` | обычно запросы с [неидемпотентным](https://datatracker.ietf.org/doc/html/rfc7231#section-4.2.2) методом (POST, LOCK, PATCH) не передаются на другой сервер, если запрос серверу группы уже был отправлен; включение параметра явно разрешает повторять подобные запросы; | | `off` | запрещает передачу запроса следующему серверу. | Если все upstream‑серверы недоступны или возвращают ответ со статусом, считающимся ошибкой для `proxy_next_upstream`, Angie возвращает собственную стандартную страницу ошибки вместо тела ответа от последнего upstream‑сервера. #### NOTE Необходимо понимать, что передача запроса следующему серверу возможна только при условии, что клиенту еще ничего не передавалось. То есть, если ошибка или таймаут возникли в середине передачи ответа клиенту, то действие директивы на такой запрос не распространяется. Директива также определяет, что считается [неудачной попыткой](https://angie.software//angie/docs/configuration/modules/http/http_upstream.md#max-fails) работы с сервером. | `error`

`timeout`

`invalid_header` | всегда считаются неудачными попытками, даже если они не указаны в директиве | |--------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------| | `http_500`

`http_502`

`http_503`

`http_504`

`http_429` | считаются неудачными попытками, только если они указаны в директиве | | `http_403`

`http_404` | никогда не считаются неудачными попытками | Передача запроса следующему серверу может быть ограничена по [количеству попыток](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-next-upstream-tries) и по [времени](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-next-upstream-timeout). ### proxy_next_upstream_timeout | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_next_upstream_timeout` время; | |------------------------------------------------------------------------------------------|----------------------------------------| | По умолчанию | `proxy_next_upstream_timeout 0;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Ограничивает время, в течение которого возможна передача запроса [следующему](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-next-upstream) серверу. | `0` | отключает это ограничение | |-------|-----------------------------| ### proxy_next_upstream_tries | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_next_upstream_tries` число; | |------------------------------------------------------------------------------------------|--------------------------------------| | По умолчанию | `proxy_next_upstream_tries 0;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Ограничивает число допустимых попыток для передачи запроса [следующему](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-next-upstream) серверу. | `0` | отключает это ограничение | |-------|-----------------------------| ### proxy_no_cache | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_no_cache` строка ...; | |------------------------------------------------------------------------------------------|--------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает условия, при которых ответ не будет сохраняться в кэш. Если значение хотя бы одного из строковых параметров непустое и не равно "0", то ответ не будет сохранен: ```nginx proxy_no_cache $cookie_nocache $arg_nocache$arg_comment; proxy_no_cache $http_pragma $http_authorization; ``` Можно использовать совместно с директивой [proxy_cache_bypass](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache-bypass). ### proxy_pass | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_pass` uri; | |------------------------------------------------------------------------------------------|---------------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | location, if в location, limit_except | Задает протокол и адрес проксируемого сервера, а также необязательный URI, на который должен отображаться location. В качестве протокола можно указать `http` или `https`. Адрес может быть указан в виде доменного имени или IP-адреса, и необязательного порта: ```nginx proxy_pass http://localhost:8000/uri/; ``` или в виде пути UNIX-сокета, который указывается после слова `unix` и заключается в двоеточия: ```nginx proxy_pass http://unix:/tmp/backend.socket:/uri/; ``` Если доменному имени соответствует несколько адресов, то все они будут использоваться по очереди (round-robin). Кроме того, в качестве адреса можно указать [группу серверов](https://angie.software//angie/docs/configuration/modules/http/http_upstream.md#http-upstream). В значении параметра можно использовать переменные. В этом случае, если адрес указан в виде доменного имени, имя ищется среди описанных групп серверов и если не найдено, то определяется с помощью [resolver](https://angie.software//angie/docs/configuration/modules/http/index.md#resolver)'а. URI запроса передается на сервер так: * Если директива `proxy_pass` указана **с URI**, то при передаче запроса серверу часть [нормализованного](https://angie.software//angie/docs/configuration/modules/http/index.md#location) URI запроса, соответствующая location, заменяется на URI, указанный в директиве: ```nginx location /name/ { proxy_pass http://127.0.0.1/remote/; } ``` * Если директива `proxy_pass` указана **без URI**, то при обработке первоначального запроса на сервер передается URI запроса в том же виде, в каком его прислал клиент, а при обработке измененного URI - нормализованный URI запроса целиком: ```nginx location /some/path/ { proxy_pass http://127.0.0.1; } ``` В ряде случаев часть URI запроса, подлежащую замене, выделить невозможно: * Если `location` задан регулярным выражением, а также в именованных `location`. В этих случаях `proxy_pass` следует указывать без URI. * Если внутри проксируемого `location` с помощью директивы [rewrite](https://angie.software//angie/docs/configuration/modules/http/http_rewrite.md#id5) изменяется URI, и именно с этой конфигурацией будет обрабатываться запрос (break): ```nginx location /name/ { rewrite /name/([^/]+) /users?name=$1 break; proxy_pass http://127.0.0.1; } ``` В этом случае URI, указанный в директиве, игнорируется, и на сервер передается измененный URI запроса целиком. * При использовании переменных в proxy_pass: ```nginx location /name/ { proxy_pass http://127.0.0.1$request_uri; } ``` В этом случае если в директиве указан URI, он передается на сервер как есть, заменяя URI первоначального запроса. Проксирование WebSocket требует особой [настройки](https://angie.software//angie/docs/configuration/processing.md#websocket-proxy). #### NOTE Если `proxy_pass` стоит в `location` с косой чертой в конце префикса (например, `location /name/`), и при этом в директиве [auto_redirect](https://angie.software//angie/docs/configuration/modules/http/index.md#auto-redirect) указано `default`, запросы без косой черты в конце будут перенаправляться (`/name -> /name/`). ### proxy_pass_header | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_pass_header` поле ...; | |------------------------------------------------------------------------------------------|---------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Разрешает передавать от проксируемого сервера клиенту [запрещенные для передачи](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-hide-header) поля заголовка. ### proxy_pass_request_body | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_pass_request_body` `on` | `off`; | |------------------------------------------------------------------------------------------|-------------------------------------------| | По умолчанию | `proxy_pass_request_body on;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Позволяет запретить передачу исходного тела запроса на проксируемый сервер. ```nginx location /x-accel-redirect-here/ { proxy_method GET; proxy_pass_request_body off; proxy_set_header Content-Length ""; proxy_pass ...; } ``` См. также директивы [proxy_set_header](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-set-header) и [proxy_pass_request_headers](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-pass-request-headers). ### proxy_pass_request_headers | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_pass_request_headers` `on` | `off`; | |------------------------------------------------------------------------------------------|----------------------------------------------| | По умолчанию | `proxy_pass_request_headers on;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Позволяет запретить передачу полей заголовка исходного запроса на проксируемый сервер. ```nginx location /x-accel-redirect-here/ { proxy_method GET; proxy_pass_request_headers off; proxy_pass_request_body off; proxy_pass ...; } ``` См. также директивы [proxy_set_header](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-set-header) и [proxy_pass_request_body](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-pass-request-body). ### proxy_pass_trailers | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_pass_trailers` `on` | `off`; | |------------------------------------------------------------------------------------------|---------------------------------------| | По умолчанию | `proxy_pass_trailers off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Разрешает передачу полей трейлеров от проксируемого сервера клиенту. Секция трейлеров в HTTP/1.1 [включается явно](https://datatracker.ietf.org/doc/html/rfc9110#section-6.5.1). ```nginx location / { proxy_http_version 1.1; proxy_set_header Connection "te"; proxy_set_header TE "trailers"; proxy_pass_trailers on; proxy_pass ...; } ``` ### proxy_quic_active_connection_id_limit | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_quic_active_connection_id_limit` число; | |------------------------------------------------------------------------------------------|--------------------------------------------------| | По умолчанию | `proxy_quic_active_connection_id_limit 2;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server | Задает значение транспортного параметра [QUIC](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-http-version) `active_connection_id_limit`. Это максимальное число активных [идентификаторов соединений](https://www.rfc-editor.org/rfc/rfc9000.html#name-connection-id), поддерживаемых для одного сервера. ### proxy_quic_gso | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_quic_gso` `on` | `off`; | |------------------------------------------------------------------------------------------|----------------------------------| | По умолчанию | `proxy_quic_gso off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server | Отключает или включает отправку данных в оптимизированном пакетном режиме [QUIC](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-http-version), использующем программное снижение нагрузки путем сегментации ([generic segmentation offload](https://docs.kernel.org/networking/segmentation-offloads.html#generic-segmentation-offload)). ### proxy_quic_host_key | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_quic_host_key` файл; | |------------------------------------------------------------------------------------------|-------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server | Задает файл с секретным ключом, применяемым в [QUIC](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-http-version) при шифровании токенов [Stateless Reset](https://www.rfc-editor.org/rfc/rfc9000.html#name-stateless-reset) и [Address Validation](https://www.rfc-editor.org/rfc/rfc9000.html#address-validation). По умолчанию случайный ключ создается при каждом перезапуске. Токены, созданные при помощи старых ключей, не принимаются. ### proxy_read_timeout | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_read_timeout` время; | |------------------------------------------------------------------------------------------|-------------------------------| | По умолчанию | `proxy_read_timeout 60s;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает таймаут при чтении ответа проксированного сервера. Таймаут устанавливается не на всю передачу ответа, а только между двумя операциями чтения. Если по истечении этого времени проксируемый сервер ничего не передаст, соединение закрывается. ### proxy_redirect | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_redirect` `default`;

`proxy_redirect` `off`;

`proxy_redirect` перенаправление замена; | |------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------| | По умолчанию | `proxy_redirect default;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает текст, который нужно изменить в полях заголовка "Location" и "Refresh" в ответе проксируемого сервера. Предположим, проксируемый сервер вернул поле заголовка: ```console Location: http://localhost:8000/two/some/uri/ ``` Директива ```nginx proxy_redirect http://localhost:8000/two/ http://frontend/one/; ``` перепишет эту строку в виде: ```console Location: http://frontend/one/some/uri/ ``` В заменяемой строке можно не указывать имя сервера: ```nginx proxy_redirect http://localhost:8000/two/ /; ``` тогда будут подставлены основное имя сервера и порт, если он отличен от 80. Стандартная замена, задаваемая параметром `default`, использует параметры директив [location](https://angie.software//angie/docs/configuration/modules/http/index.md#location) и [proxy_pass](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-pass). Поэтому две нижеприведенные конфигурации одинаковы: ```nginx location /one/ { proxy_pass http://upstream:port/two/; proxy_redirect default; ``` ```nginx location /one/ { proxy_pass http://upstream:port/two/; proxy_redirect http://upstream:port/two/ /one/; ``` #### WARNING Параметр `default` недопустим, если в [proxy_pass](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-pass) используются переменные. В строке замена можно использовать переменные: ```nginx proxy_redirect http://localhost:8000/ http://$host:$server_port/; ``` В строке перенаправление тоже можно использовать переменные: ```nginx proxy_redirect http://$proxy_host:8000/ /; ``` Директиву также можно задать при помощи регулярных выражений. При этом перенаправление должно начинаться либо с символа "~", если при сравнении следует учитывать регистр символов, либо с символов "~\*", если регистр символов учитывать не нужно. Регулярное выражение может содержать именованные и позиционные группы захвата, а замена ссылаться на них: ```nginx proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2; proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2; ``` На одном уровне может быть указано несколько директив proxy_redirect: ```nginx proxy_redirect default; proxy_redirect http://localhost:8000/ /; proxy_redirect http://www.example.com/ /; ``` Если к полям заголовка в ответе проксируемого сервера могут быть применены несколько директив, будет выбрана первая из них. Параметр `off` отменяет действие унаследованных с предыдущего уровня конфигурации директив proxy_redirect. С помощью этой директивы можно также добавлять имя хоста к относительным перенаправлениям, выдаваемым проксируемым сервером: ```nginx proxy_redirect / /; ``` ### proxy_request_buffering | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_request_buffering` `on` | `off`; | |------------------------------------------------------------------------------------------|-------------------------------------------| | По умолчанию | `proxy_request_buffering on;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Разрешает или запрещает использовать буферизацию тела запроса клиента. | `on` | тело запроса полностью [читается](https://angie.software//angie/docs/configuration/modules/http/index.md#client-body-buffer-size) от клиента перед отправкой запроса на проксируемый сервер. | |--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `off` | тело запроса отправляется на проксируемый сервер сразу же по мере его поступления. В этом случае запрос не может быть передан [следующему серверу](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-next-upstream), если Angie уже начал отправку тела запроса. | Если для отправки тела исходного запроса используется HTTP/1.1 и передача данных частями (chunked transfer encoding), то тело запроса буферизуется независимо от значения директивы, если для проксирования также не [включен](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-http-version) HTTP/1.1. ### proxy_send_lowat | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_send_lowat` размер; | |------------------------------------------------------------------------------------------|------------------------------| | По умолчанию | `proxy_send_lowat 0;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | При установке директивы в ненулевое значение Angie будет пытаться минимизировать число операций отправки на исходящих соединениях с проксируемым сервером либо при помощи флага `NOTE_LOWAT` метода [kqueue](https://angie.software//angie/docs/configuration/processing.md#kqueue), либо при помощи параметра сокета `SO_SNDLOWAT`, с указанным размером. #### NOTE Эта директива игнорируется на Linux, Solaris и Windows. ### proxy_send_timeout | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_send_timeout` время; | |------------------------------------------------------------------------------------------|-------------------------------| | По умолчанию | `proxy_send_timeout 60s;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает таймаут при передаче запроса проксируемому серверу. Таймаут устанавливается не на всю передачу запроса, а только между двумя операциями записи. Если по истечении этого времени проксируемый сервер не примет новых данных, соединение закрывается. ### proxy_set_body | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_set_body` значение; | |------------------------------------------------------------------------------------------|------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Позволяет переопределить тело запроса, передаваемое на проксируемый сервер. В качестве значения можно использовать текст, переменные и их комбинации. ### proxy_set_header | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_set_header` поле значение; | |------------------------------------------------------------------------------------------|--------------------------------------| | По умолчанию | `proxy_set_header Host $proxy_host;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Позволяет переопределять или добавлять поля заголовка запроса, [передаваемые](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-pass-request-headers) проксируемому серверу. В качестве значения можно использовать текст, переменные и их комбинации. Директивы наследуются с предыдущего уровня конфигурации при условии, что на данном уровне не описаны свои директивы proxy_set_header. По умолчанию переопределяются только два поля: ```nginx proxy_set_header Host $proxy_host; proxy_set_header Connection close; ``` Если включено кэширование, поля заголовка `If-Modified-Since` , `If-Unmodified-Since` , `If-None-Match` , `If-Match` , `Range` и `If-Range` исходного запроса не передаются на проксируемый сервер. Неизмененное поле заголовка запроса "Host" можно передать так: ```nginx proxy_set_header Host $http_host; ``` Однако, если это поле отсутствует в заголовке запроса клиента, то ничего передаваться не будет. В этом случае лучше воспользоваться переменной [$host](https://angie.software//angie/docs/configuration/modules/http/index.md#v-host) - ее значение равно имени сервера в поле "Host" заголовка запроса, или же основному имени сервера, если поля нет: ```nginx proxy_set_header Host $host; ``` Кроме того, можно передать имя сервера вместе с портом проксируемого сервера: ```nginx proxy_set_header Host $host:$proxy_port; ``` Если значение поля заголовка — пустая строка, то поле вообще не будет передаваться проксируемому серверу: ```nginx proxy_set_header Accept-Encoding ""; ``` ### proxy_socket_keepalive | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_socket_keepalive` `on` | `off`; | |------------------------------------------------------------------------------------------|------------------------------------------| | По умолчанию | `proxy_socket_keepalive off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Конфигурирует поведение "TCP keepalive" для исходящих соединений к проксируемому серверу. | `""` | По умолчанию для сокета действуют настройки операционной системы. | |--------|---------------------------------------------------------------------| | `on` | для сокета включается параметр SO_KEEPALIVE | ### proxy_ssl_certificate | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_certificate` файл [файл]; | |------------------------------------------------------------------------------------------|----------------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает файл с сертификатом в формате PEM для аутентификации на проксируемом HTTPS-сервере. В имени файла можно использовать переменные. При включенном [proxy_ssl_ntls](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-ssl-ntls) директива принимает два аргумента вместо одного: ```nginx location /proxy { proxy_ssl_ntls on; proxy_ssl_certificate sign.crt enc.crt; proxy_ssl_certificate_key sign.key enc.key; proxy_ssl_ciphers "ECC-SM2-WITH-SM4-SM3:ECDHE-SM2-WITH-SM4-SM3:RSA"; proxy_pass https://backend:443; } ``` ### proxy_ssl_certificate_cache | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_certificate_cache` `off`;

`proxy_ssl_certificate_cache` `max=`N [`inactive=`time] [`valid=`time]; | |------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------| | Значение по умолчанию | `proxy_ssl_certificate_cache off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Определяет кэш для хранения [SSL-сертификатов](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-ssl-certificate) и [секретных ключей](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-ssl-certificate-key), заданных через переменные. Директива поддерживает следующие параметры: - `max` — устанавливает максимальное количество элементов в кэше. При переполнении кэша удаляются наименее недавно использованные (LRU) элементы. - `inactive` — определяет время, после которого элемент будет удален, если к нему не было обращений. Значение по умолчанию — 10 секунд. - `valid` — определяет время, в течение которого элемент кэша считается действительным и может использоваться повторно. Значение по умолчанию — 60 секунд. По истечении этого времени сертификаты перезагружаются или проходят повторную проверку. - `off` — отключает кэш. Пример: ```nginx proxy_ssl_certificate $proxy_ssl_server_name.crt; proxy_ssl_certificate_key $proxy_ssl_server_name.key; proxy_ssl_certificate_cache max=1000 inactive=20s valid=1m; ``` ### proxy_ssl_certificate_key | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_certificate_key` файл [файл]; | |------------------------------------------------------------------------------------------|--------------------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает файл с секретным ключом в формате PEM для аутентификации на проксируемом HTTPS-сервере. Вместо файла можно указать значение `engine:`name`:id`, которое загружает ключ с указанным id из OpenSSL engine с заданным именем. Вместо файла можно указать значение `store:scheme:id`, которое используется для загрузки ключа с указанным id и URI-схемой scheme, зарегистрированной в OpenSSL provider, например [pkcs11](https://datatracker.ietf.org/doc/html/rfc7512). В имени файла можно использовать переменные. При включенном [proxy_ssl_ntls](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-ssl-ntls) директива принимает два аргумента вместо одного: ```nginx location /proxy { proxy_ssl_ntls on; proxy_ssl_certificate sign.crt enc.crt; proxy_ssl_certificate_key sign.key enc.key; proxy_ssl_ciphers "ECC-SM2-WITH-SM4-SM3:ECDHE-SM2-WITH-SM4-SM3:RSA"; proxy_pass https://backend:443; } ``` ### proxy_ssl_ciphers | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_ciphers` шифры; | |------------------------------------------------------------------------------------------|------------------------------| | По умолчанию | `proxy_ssl_ciphers DEFAULT;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Описывает разрешенные шифры для запросов к проксируемому HTTPS-серверу. Шифры задаются в формате, поддерживаемом библиотекой OpenSSL. Список шифров зависит от установленной версии OpenSSL. Полный список можно посмотреть с помощью команды `openssl ciphers`. #### WARNING Директива `proxy_ssl_ciphers` *не* настраивает шифры для TLS 1.3 при использовании OpenSSL. Для настройки шифров TLS 1.3 в OpenSSL используйте директиву [proxy_ssl_conf_command](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-ssl-conf-command), добавленную для расширенной конфигурации SSL. - В LibreSSL шифры TLS 1.3 *можно* настраивать с помощью `proxy_ssl_ciphers`. - В BoringSSL шифры TLS 1.3 настроить невозможно. ### proxy_ssl_conf_command | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_conf_command` имя значение; | |------------------------------------------------------------------------------------------|------------------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает произвольные конфигурационные [команды](https://docs.openssl.org/master/man3/SSL_CONF_cmd/) OpenSSL при установлении соединения с проксируемым HTTPS-сервером. #### NOTE Директива поддерживается при использовании OpenSSL 1.0.2 и выше. Чтобы настроить шифры TLS 1.3 в OpenSSL, используйте команду `ciphersuites`. На одном уровне может быть указано несколько директив proxy_ssl_conf_command. Директивы наследуются с предыдущего уровня конфигурации при условии, что на данном уровне не описаны свои директивы proxy_ssl_conf_command. #### WARNING Следует учитывать, что изменение настроек OpenSSL напрямую может привести к неожиданному поведению. ### proxy_ssl_crl | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_crl` файл; | |------------------------------------------------------------------------------------------|-------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Указывает файл с отозванными сертификатами (CRL) в формате PEM, используемыми при [проверке](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-ssl-verify) сертификата проксируемого HTTPS-сервера. ### proxy_ssl_name | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_name` имя; | |------------------------------------------------------------------------------------------|-------------------------------| | По умолчанию | `proxy_ssl_name $proxy_host;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Позволяет переопределить имя сервера, используемое при [проверке](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-ssl-verify) сертификата проксируемого HTTPS-сервера, а также для [передачи его через SNI](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-ssl-server-name) при установлении соединения с проксируемым HTTPS-сервером. По умолчанию используется имя хоста из URL'а, заданного директивой [proxy_pass](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-pass). ### proxy_ssl_ntls | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_ntls` `on` | `off`; | |------------------------------------------------------------------------------------------|----------------------------------| | По умолчанию | `proxy_ssl_ntls off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server | Включает клиентскую поддержку NTLS при использовании TLS библиотеки [TongSuo](https://github.com/Tongsuo-Project/Tongsuo). ```nginx location /proxy { proxy_ssl_ntls on; proxy_ssl_certificate sign.crt enc.crt; proxy_ssl_certificate_key sign.key enc.key; proxy_ssl_ciphers "ECC-SM2-WITH-SM4-SM3:ECDHE-SM2-WITH-SM4-SM3:RSA"; proxy_pass https://backend:443; } ``` #### NOTE Angie необходимо собрать с использованием параметра конфигурации `--with-ntls`, с соответствующей SSL библиотекой с поддержкой NTLS ```default ./configure --with-openssl=../Tongsuo-8.3.0 \ --with-openssl-opt=enable-ntls \ --with-ntls ``` ### proxy_ssl_password_file | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_password_file` файл; | |------------------------------------------------------------------------------------------|-----------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает файл с паролями от [секретных ключей](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-ssl-certificate-key), где каждый пароль указан на отдельной строке. Пароли применяются по очереди в момент загрузки ключа. ### proxy_ssl_protocols | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_protocols` [`SSLv2`] [`SSLv3`] [`TLSv1`] [`TLSv1.1`] [`TLSv1.2`] [`TLSv1.3`]; | |------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------| | По умолчанию | `proxy_ssl_protocols TLSv1.2 TLSv1.3;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | #### Versionchanged Изменено в версии 1.2.0: Параметр `TLSv1.3` добавлен к используемым по умолчанию. Разрешает указанные протоколы для запросов к проксируемому HTTPS-серверу. ### proxy_ssl_server_name | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_server_name` `on` | `off`; | |------------------------------------------------------------------------------------------|-----------------------------------------| | По умолчанию | `proxy_ssl_server_name off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Разрешает или запрещает передачу имени сервера, заданного директивой [proxy_ssl_name](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-ssl-name), через расширение [Server Name Indication](http://en.wikipedia.org/wiki/Server_Name_Indication) протокола TLS (SNI, [RFC 6066](https://datatracker.ietf.org/doc/html/rfc6066.html)) при установлении соединения с проксируемым HTTPS-сервером. ### proxy_ssl_session_reuse | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_session_reuse` `on` | `off`; | |------------------------------------------------------------------------------------------|-------------------------------------------| | По умолчанию | `proxy_ssl_session_reuse on;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Определяет, использовать ли повторно SSL-сессии при работе с проксируемым сервером. Если в логах появляются ошибки "SSL3_GET_FINISHED:digest check failed", то можно попробовать выключить повторное использование сессий. ### proxy_ssl_trusted_certificate | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_trusted_certificate` файл; | |------------------------------------------------------------------------------------------|-----------------------------------------| | По умолчанию | — | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает файл с доверенными сертификатами CA в формате PEM, используемыми при [проверке](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-ssl-verify) сертификата проксируемого HTTPS-сервера. ### proxy_ssl_verify | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_verify` `on` | `off`; | |------------------------------------------------------------------------------------------|------------------------------------| | По умолчанию | `proxy_ssl_verify off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Разрешает или запрещает проверку сертификата проксируемого HTTPS-сервера. ### proxy_ssl_verify_depth | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_ssl_verify_depth` число; | |------------------------------------------------------------------------------------------|-----------------------------------| | По умолчанию | `proxy_ssl_verify_depth 1;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Устанавливает глубину проверки в цепочке сертификатов проксируемого HTTPS-сервера. ### proxy_store | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_store` `on` | `off` | строка; | |------------------------------------------------------------------------------------------|----------------------------------------| | По умолчанию | `proxy_store off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Разрешает сохранение на диск файлов. | `on` | сохраняет файлы в соответствии с путями, указанными в директивах [alias](https://angie.software//angie/docs/configuration/modules/http/index.md#alias) или [root](https://angie.software//angie/docs/configuration/modules/http/index.md#root) | |--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `off` | запрещает сохранение файлов | Имя файла можно задать явно с помощью `строки` с переменными: ```nginx proxy_store /data/www$original_uri; ``` Время изменения файлов выставляется согласно полученному полю `Last-Modified` в заголовке ответа. Ответ сначала записывается во временный файл, а потом этот файл переименовывается. Временный файл и постоянное место хранения ответа могут располагаться на разных файловых системах. Однако нужно учитывать, что в этом случае вместо дешевой операции переименовывания в пределах одной файловой системы файл копируется с одной файловой системы на другую. Поэтому лучше, если сохраняемые файлы будут находиться на той же файловой системе, что и каталог с временными файлами, задаваемый директивой [proxy_temp_path](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-temp-path) для данного location. Директиву можно использовать для создания локальных копий статических неизменяемых файлов, например, так: ```nginx location /images/ { root /data/www; 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/; } ``` или так: ```nginx 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; } ``` ### proxy_store_access | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_store_access` пользователи:права ...; | |------------------------------------------------------------------------------------------|------------------------------------------------| | По умолчанию | `proxy_store_access user:rw;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает права доступа для создаваемых файлов и каталогов, например, ```nginx proxy_store_access user:rw group:rw all:r; ``` Если заданы какие-либо права для group или all, то права для user указывать необязательно: ```nginx proxy_store_access group:rw all:r; ``` ### proxy_temp_file_write_size | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_temp_file_write_size` размер; | |------------------------------------------------------------------------------------------|----------------------------------------| | По умолчанию | `proxy_temp_file_write_size 8k|16k;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Ограничивает размер данных, сбрасываемых во временный файл за один раз, при включенной буферизации ответов проксируемого сервера во временные файлы. По умолчанию размер ограничен двумя буферами, заданными директивами [proxy_buffer_size](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-buffer-size) и [proxy_buffers](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-buffers). Максимальный размер временного файла задается директивой [proxy_max_temp_file_size](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-max-temp-file-size). ### proxy_temp_path | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `proxy_temp_path` путь [уровень1 [уровень2 [уровень3]]]\`; | |------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------| | По умолчанию | `proxy_temp_path proxy_temp;`
(путь зависит от [параметра сборки](https://angie.software//angie/docs/installation/sourcebuild.md#paths) `--http-proxy-temp-path`) | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Задает имя каталога для хранения временных файлов с данными, полученными от проксируемых серверов. В каталоге может использоваться иерархия подкаталогов до трех уровней. Например, при такой конфигурации ```nginx proxy_temp_path /spool/angie/proxy_temp 1 2; ``` временный файл будет следующего вида: ```nginx /spool/angie/proxy_temp/7/45/00000123457 ``` См. также параметр use_temp_path директивы [proxy_cache_path](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-cache-path). ## Встроенные переменные В модуле http_proxy есть встроенные переменные, которые можно использовать для формирования заголовков с помощью директивы [proxy_set_header](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-set-header): ### `$proxy_host` имя и порт проксируемого сервера, как указано в директиве [proxy_pass](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-pass); ### `$proxy_port` порт проксируемого сервера, как указано в директиве [proxy_pass](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#proxy-pass), или стандартный порт протокола; ### `$proxy_add_x_forwarded_for` поле заголовка запроса клиента `X-Forwarded-For` и добавленная к нему через запятую переменная [$remote_addr](https://angie.software//angie/docs/configuration/modules/http/index.md#v-remote-addr). Если же поля `X-Forwarded-For` в заголовке запроса клиента нет, то переменная [$proxy_add_x_forwarded_for](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#v-proxy-add-x-forwarded-for) равна переменной [$remote_addr](https://angie.software//angie/docs/configuration/modules/http/index.md#v-remote-addr).