Перейти к содержанию

unbrotli: Декодирует ответы, закодированные с помощью Brotli, для клиентов, которые не поддерживают его

Установка

Вы можете установить этот модуль в любой дистрибутив на базе RHEL, включая, но не ограничиваясь:

  • RedHat Enterprise Linux 7, 8, 9 и 10
  • CentOS 7, 8, 9
  • AlmaLinux 8, 9
  • Rocky Linux 8, 9
  • Amazon Linux 2 и Amazon Linux 2023
dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install nginx-module-unbrotli

yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install nginx-module-unbrotli

Включите модуль, добавив следующее в верхнюю часть файла /etc/nginx/nginx.conf:

load_module modules/ngx_http_unbrotli_filter_module.so;

Этот документ описывает nginx-module-unbrotli v0.0.2, выпущенный 18 декабря 2024 года.

ngx_unbrotli — это фильтр-модуль, который декодирует ответы, закодированные с помощью Brotli (Content-Encoding: br), для клиентов, которые не поддерживают Brotli. Храня ответы в формате Brotli, вы можете сэкономить на хранении и затратах на ввод-вывод, а этот модуль гарантирует, что клиенты, не способные обрабатывать Brotli, все равно получают соответствующий декодированный контент.

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

location /storage/ {
    unbrotli on;
    unbrotli_buffers 32 4k;
    ...
}

Директивы конфигурации

unbrotli

  • синтаксис: unbrotli on | off;
  • по умолчанию: off
  • контекст: http, server, location

Включает или отключает декодирование ответов, сжатых с помощью Brotli (Content-Encoding: br), для клиентов, которые не поддерживают Brotli. Когда unbrotli включен, сервер проверяет возможности клиента (аналогично тому, как обрабатывается gzip), чтобы определить, требуется ли декодирование.

unbrotli_force

  • синтаксис: unbrotli_force on | off;
  • по умолчанию: off
  • контекст: http, server, location

Принудительно декодирует ответы, сжатые с помощью Brotli, даже если клиент указывает на поддержку Brotli. Когда unbrotli_force установлен в on, все ответы, закодированные с помощью Brotli, декодируются перед отправкой клиенту, независимо от заголовка Accept-Encoding клиента.

unbrotli_buffers

  • синтаксис: unbrotli_buffers number size;
  • по умолчанию: зависит от размера страницы системы, обычно: unbrotli_buffers 32 4k; или unbrotli_buffers 16 8k;
  • контекст: http, server, location

Устанавливает количество и размер буферов, используемых для декодирования ответов Brotli. Обычно размер равен одной странице памяти (4 КБ или 8 КБ, в зависимости от платформы). Увеличение количества или размера этих буферов может улучшить производительность для больших ответов за счет большего использования памяти.

GitHub

Вы можете найти дополнительные советы по конфигурации и документацию для этого модуля в репозитории GitHub для nginx-module-unbrotli.