Пaраметр buffers#

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

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

client_body_buffer_size

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

Тип параметра: текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.
По умолчанию: размер буфера равен двум страницам памяти. Для x86:
```
client_body_buffer_size: 8K
```
client_body_in_file_only

В значение параметра определяется, должен ли nginx сохранять все тело запроса клиента в файл.

Тип параметра: строковое значение.
- «on»;
- «off»;
- «clean».
По умолчанию:
```
client_body_in_file_only: "off"
```
client_body_in_single_buffer

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

Тип параметра: строковое значение.
- «on»;
- «off».
По умолчанию:
```
client_body_in_single_buffer: "off"
```
client_header_buffer_size

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

Тип параметра: текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.
По умолчанию:
```
client_header_buffer_size: 1k
```
large_client_header_buffers

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

Тип параметра: группа параметров и их значения.

По умолчанию:
```
large_client_header_buffers:
  number: 4
  size: 8k
```
Обязательные параметры:
- number
  
  В значение параметра устанавливается максимальное количество буферов.
  
  Тип параметра: целочисленное значение.
  
  По умолчанию:
```
number: 4
```
- size
  
  В значение параметра устанавливается размер буферов.
  
  Тип параметра: текстовое значение с суффиксом:
  - число без суффикса — байты;
  - k / K — килобайты;
  - m / M — мегабайты.
  По умолчанию:
```
size: 4k
```
output_buffers

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

Тип параметра: группа параметров и их значения.

По умолчанию:
```
output_buffers:
  number: 2
  size: 32k
```
Обязательные параметры:
- number
  
  В значение параметра устанавливается максимальное количество буферов.
  
  Тип параметра: целочисленное значение.
  
  По умолчанию:
```
number: 2
```
- size
  
  В значение параметра устанавливается размер буферов.
  
  Тип параметра: текстовое значение с суффиксом:
  - число без суффикса — байты;
  - k / K — килобайты;
  - m / M — мегабайты.
  По умолчанию:
```
size: 32k
```
subrequest_output_buffer_size

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

Тип параметра: текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.
По умолчанию: размер буфера равен одной странице памяти. Для х86:
```
subrequest_output_buffer_size: 4k
```
proxy_buffer_size

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

Тип параметра: текстовое значение с суффиксом:
- число без суффикса — байты;
- k / K — килобайты;
- m / M — мегабайты.
По умолчанию: размер буфера равен одной странице памяти. Для х86:
```
proxy_buffer_size: 4k
```
proxy_buffering

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

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

Тип параметра: строковое значение.
- «on»;
- «off».
По умолчанию:
```
proxy_buffering: "on"
```
proxy_buffers

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

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

Тип параметра: группа параметров и их значения.

По умолчанию:
```
proxy_buffers:
  number: 2
  size: 32k
```
Обязательные параметры:
- number
  
  В значение параметра устанавливается максимальное количество буферов.
  
  Тип параметра: целочисленное значение.
  
  По умолчанию:
```
number: 2
```
- size
  
  В значение параметра устанавливается размер буферов.
  
  Тип параметра: текстовое значение с суффиксом:
  - число без суффикса — байты;
  - k / K — килобайты;
  - m / M — мегабайты.
  По умолчанию:
```
size: 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».
По умолчанию:
```
proxy_request_buffering: "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