client_body_buffer_size

Описание

Директива `client_body_buffer_size` указывает максимальный размер буфера, который NGINX будет использовать для чтения тела запроса клиента. Если тело превышает этот размер, NGINX запишет его во временный файл, что помогает управлять использованием памяти и повышать производительность, позволяя загружать большие файлы без исчерпания ресурсов памяти. Директиву можно устанавливать в контекстах `http`, `server` или `location`, что позволяет гибко настраивать её в зависимости от потребностей конкретного приложения. Когда поступает тело запроса, NGINX сравнивает размер запроса с указанным `client_body_buffer_size`. Если размер находится в пределах лимита, тело буферизуется в памяти; в противном случае оно сохраняется в файл на диске. Такое поведение важно для приложений, которые обрабатывают загрузки файлов или большие полезные нагрузки, поскольку правильная настройка размера буфера может оптимизировать как потребление памяти, так и скорость обработки. Значение может указываться в байтах, килобайтах (k), мегабайтах (m) и т.д., что позволяет тонко настроить параметр в зависимости от ожидаемого размера входящих запросов. Эта директива обычно используется вместе с другими связанными настройками, такими как `client_max_body_size`, которая задаёт максимальный допустимый размер тела запроса клиента в целом. Это дополнительно обеспечивает корректное управление ресурсами и предотвращает злоупотребления чрезмерно крупными загрузками.

Пример конфига

http {
    client_body_buffer_size 32k;
}