Пaраметр buffers#

Параметры buffers описываются, как правило, в секции optional сервиса.

Опциональные параметры:

Название

Обязательность

Описание

Возможные значения

Значение по умолчанию

client_body_buffer_size

Опциональный

Размер буфера для чтения тела запроса клиента.

Текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.

8K (две страницы памяти для x86)

client_body_in_file_only

Опциональный

Должен ли nginx сохранять всё тело запроса клиента в файл.

Строковое значение:
- "on";
- "off";
- "clean".

"off"

client_body_in_single_buffer

Опциональный

Должен ли nginx сохранять всё тело запроса клиента в одном буфере.

Строковое значение:
- "on";
- "off".

"off"

client_header_buffer_size

Опциональный

Размер буфера для чтения заголовка запроса клиента.

Текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.

1k

large_client_header_buffers

Опциональный

Максимальное количество и размер буферов, используемых для чтения большого заголовка запроса клиента.

Группа параметров и их значения (см. вложенные параметры ниже).

number: 4
size: 8k

    number

Обязательный

Максимальное количество буферов.

Целочисленное значение.

4

    size

Обязательный

Размер буферов.

Текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.

4k

output_buffers

Опциональный

Количество и размер буферов, используемых для чтения ответа с диска.

Группа параметров и их значения (см. вложенные параметры ниже).

number: 2
size: 32k

    number

Обязательный

Максимальное количество буферов.

Целочисленное значение.

2

    size

Обязательный

Размер буферов.

Текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.

32k

subrequest_output_buffer_size

Опциональный

Размер буфера, используемого для хранения тела ответа подзапроса.

Текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.

4k (одна страница памяти для x86)

proxy_buffer_size

Опциональный

Размер буфера, используемого для чтения первой части ответа, полученного от прокси-сервера.

Текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.

4k (одна страница памяти для x86)

proxy_buffering

Опциональный

Вкл./Откл. буферизация ответов с прокси-сервера.

Недоступно в случае указания http_version = 2.0.

Строковое значение:
- "on";
- "off".

"on"

proxy_buffers

Опциональный

Количество и размер буферов, используемых для чтения ответа от прокси-сервера, для одного соединения.

Недоступно в случае указания http_version = 2.0.

Группа параметров и их значения (см. вложенные параметры ниже).

number: 2
size: 32k

    number

Обязательный

Максимальное количество буферов.

Целочисленное значение.

2

    size

Обязательный

Размер буферов.

Текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.

32k

proxy_busy_buffers_size

Опциональный

Ограничивается общий размер буферов, при включенной буферизации ответов от прокси-сервера, которые могут быть заняты отправкой ответа клиенту, пока ответ не будет полностью прочитан.

Недоступно в случае указания http_version = 2.0.

Текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.

Размер двух буферов, установленных директивами proxy_buffer_size и proxy_buffers

proxy_request_buffering

Опциональный

Вкл./Откл. буферизация тела запроса клиента.

Недоступно в случае указания http_version = 2.0.

Строковое значение:
- "on";
- "off".

"on"

proxy_max_temp_file_size

Опциональный

Максимальный размер временного файла, в котором может храниться часть ответов в случае, когда ответы превышают размеры буфера, установленные директивами proxy_buffer_size и proxy_buffers, при включенной буферизации ответов от прокси-сервера. Размер данных записывается во временный файл в момент установки директивы proxy_temp_file_write_size.

Недоступно в случае указания http_version = 2.0.

Текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.

Нулевое значение (отключает буферизацию ответов во временные файлы)

proxy_temp_file_write_size

Опциональный

Ограничивается размер данных, записываемых во временный файл, при включенной буферизации ответов от прокси-сервера.

Недоступно в случае указания http_version = 2.0.

Текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.

Размер двух буферов, установленных директивами proxy_buffer_size и proxy_buffers. Максимальный размер временного файла задается директивой proxy_max_temp_file_size

proxy_max_downstream_presend_inmemory_size

Опциональный

Максимальный объем данных, получаемых от backend, которые будут накапливаться в памяти прежде, чем они начнут отправляться клиенту.

Недоступно в случае указания http_version = 2.0.

Текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.

0

Определить, какой размер страницы памяти, можно выполнив команду:

getconf -a | grep PAGE_SIZE