scgi_force_ranges

Директива `scgi_force_ranges` принуждает использовать запросы диапазонов для ответов SCGI, влияя на то, как данные отправляются клиентам. — NGINX HTTP Core

scgi_force_ranges
httpserverlocation
Синтаксисscgi_force_ranges on | off;
По умолчаниюoff
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументыflag

Описание

Директива `scgi_force_ranges` в NGINX используется в модуле SCGI для указания того, как следует обрабатывать запросы частичного содержимого. При включении этой директивы (когда она установлена в 'on') NGINX будет отвечать на клиентские запросы конкретных байтовых диапазонов в ответах SCGI, соблюдая спецификацию HTTP/1.1 для запросов диапазонов. Это особенно полезно в сценариях потоковой передачи, когда клиентам может понадобиться получить только часть файла, не загружая его полностью. Когда `scgi_force_ranges` установлена в 'on', сервер проверит клиентский запрос на наличие заголовка `Range` и попытается разобрать указанные байтовые диапазоны. Такое поведение может быть полезно для медиафайлов, больших документов или любых ситуаций, когда отправка всего содержимого нецелесообразна или неэффективна. Если директива установлена в 'off', NGINX не будет учитывать запросы `Range` от клиентов и вместо этого будет отправлять им весь контент. Директива может располагаться в различных контекстах, таких как `http`, `server` или `location`, что позволяет гибко настраивать область действия для доставки частичного содержимого. Однако важно убедиться, что вышестоящее SCGI-приложение также поддерживает запросы диапазонов, иначе клиенты могут столкнуться с неожиданным поведением, если диапазоны запрошены, но не обработаны корректно вышестоящим сервером.

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

location /example {
    scgi_pass 127.0.0.1:9000;
    scgi_force_ranges on;
}

Убедитесь, что ваше SCGI-приложение поддерживает range requests; в противном случае эта директива не будет иметь эффекта.

Помните, что некоторые клиенты могут вести себя непредсказуемо, если они запрашивают ranges, а сервер не обрабатывает их должным образом.