unbrotli_force

Директива `unbrotli_force` управляет принудительной распаковкой ответов, сжатых Brotli, независимо от поддержки со стороны клиента.

Синтаксисunbrotli_force on | off;
По умолчаниюoff
Контекстhttp, server, location
Аргументыflag

Описание

Директива unbrotli_force в NGINX является частью модуля фильтра ngx_unbrotli, который отвечает за распаковку ответов, закодированных с использованием алгоритма сжатия Brotli. Когда эта директива включена, установив её в значение on, она заставляет сервер распаковывать все ответы, сжатые Brotli, обходя обычную проверку заголовка клиента Accept-Encoding, который указывает на его способность обрабатывать Brotli. Это означает, что даже клиенты, которые заявляют о поддержке Brotli, будут получать распакованный контент, что может быть полезно в отдельных случаях, когда требуются несжатые данные независимо от возможностей клиента.

Эту директиву можно настроить в различных контекстах, включая http, server и location, что делает её универсальной для разных уровней детализации конфигурации. Значение unbrotli_force по умолчанию — off, что означает, что сервер будет распаковывать ответы Brotli только для клиентов, которые не подтверждают поддержку Brotli. В сочетании с директивой unbrotli, которая должна быть включена для выполнения любой распаковки, эта директива обеспечивает точный контроль обработки ответов на основе кодирования Brotli, что полезно для узкой аудитории, которой могут требоваться исходные данные без сжатия.

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

location /assets/ {
    unbrotli on;
    unbrotli_force on;
    unbrotli_buffers 32 4k;
}

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

Используйте с осторожностью в средах, чувствительных к производительности, так как это может негативно повлиять на время отклика для клиентов, которые поддерживают Brotli compression.

Убедитесь, что brotli responses надлежащим образом обрабатываются upstream services, если они генерируют ответы, которые также являются Brotli encoded.

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