unzstd_force

Директива `unzstd_force` задаёт условия, при которых принудительно применяется декодирование zstd к HTTP-ответам, повышая совместимость с клиентами, которые не поддерживают кодирование zstd.

Синтаксисunzstd_force string ...;
По умолчаниюnone
Контекстhttp, server, location
Аргументы1+

Описание

Директива unzstd_force используется в конфигурации NGINX для принуждения к декомпрессии zstd-кодированных ответов, особенно для клиентов, у которых нет нативной поддержки этого формата кодирования. Директива принимает один или несколько строковых параметров, и если любое из этих значений задано (не пустое и не равно "0"), она заставляет сервер попытаться декомпрессировать ответы, закодированные с 'Content-Encoding: zstd'. Эта возможность особенно полезна в средах, где критична обратная совместимость со старыми клиентами, позволяя им получать данные в декомпрессированном виде, в то время как на сервере сохраняются преимущества zstd с точки зрения экономии места и эффективности ввода-вывода.

При реализации директивы unzstd_force важно учесть, что обратная связь от сервера к клиенту зависит от наличия заголовка 'Content-Encoding: zstd' в ответе. Если этот заголовок отсутствует, модуль воздерживается от попыток декомпрессии, предотвращая непредвиденное поведение. Более того, эту директиву можно размещать в различных контекстах NGINX, таких как http, server или location, что обеспечивает гибкость конфигурации в зависимости от конкретных требований маршрутизации или настройки сервера.

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

location / {
    unzstd on;
    unzstd_force "force_condition";
    proxy_pass http://backend.com;
}

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

Убедитесь, что заголовок 'Content-Encoding: zstd' правильно установлен в ответах, чтобы избежать расхождений.

Использование слишком большого числа значений в директиве unzstd_force может привести к усложнению и потенциально непреднамеренным последствиям при обработке запросов.

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