proxy_buffer_size

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

Синтаксисproxy_buffer_size size;
По умолчанию4k
Контекст
Аргументы1

Описание

Директива proxy_buffer_size — важный параметр конфигурации в модуле NGINX SRT, определяющий размер буфера, используемого для чтения начального ответа от проксируемого сервера. Это критично при использовании SRT (Secure Reliable Transport) для эффективной передачи данных, так как эта директива непосредственно влияет на то, насколько эффективно NGINX может обрабатывать входящие потоки данных и управлять использованием памяти для буферизации.

При обработке запроса NGINX может потребоваться прочитать ответ от бэкенд-сервиса, и proxy_buffer_size определяет, сколько данных может быть сохранено в буфере с бэкенда до их отправки клиенту. Больший буфер позволяет прочитать больше данных за один раз, что может снизить накладные расходы за счёт уменьшения числа операций чтения. Однако слишком большое значение может привести к неэффективному использованию памяти, особенно при высокой нагрузке, и администраторы должны найти баланс в зависимости от требований приложения.

Директива поддерживает указание различных размеров в байтах, килобайтах или мегабайтах (например, 16k, 1m). Обычно это значение настраивают исходя из ожидаемых размеров ответов от бэкенд-серверов и доступной системной памяти. Тонкая настройка этого параметра может напрямую влиять на производительность, особенно в приложениях, работающих с большими полезными нагрузками или требующих быстрых откликов.

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

srt {
    server {
        listen 4321;
        proxy_buffer_size 16k;
        proxy_pass tcp://127.0.0.1:5678;
    }
}

Установка слишком большого размера буфера может привести к чрезмерному использованию памяти, особенно при высокой нагрузке.

Если выделяется недостаточный буфер, это может привести к таймаутам соединения или ошибкам из-за неполного чтения данных с upstream server.

Важно контролировать производительность и корректировать это значение в соответствии с характеристиками рабочей нагрузки.

← Ко всем директивам