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

unzstd: Декомпрессия ответов, закодированных Zstd, для клиентов, которые не поддерживают его

Установка

Вы можете установить этот модуль в любом дистрибутиве на базе 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-unzstd
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-unzstd

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

load_module modules/ngx_http_unzstd_filter_module.so;

Этот документ описывает nginx-module-unzstd v0.1.0, выпущенный 6 января 2026 года.


server {
    listen 127.0.0.1:8080;
    server_name localhost;

    location / {
        # включить декомпрессию zstd для клиентов, которые не поддерживают сжатие zstd
        unzstd on;

        proxy_pass http://foo.com;
    }
}

Директивы

unzstd

Синтаксис: unzstd on | off;

По умолчанию: unzstd off;

Контекст: http, server, location

Включает или отключает декомпрессию ответов, сжатых zstd, для клиентов, у которых отсутствует поддержка zstd.

unzstd_force

Синтаксис: unzstd_force string ...;

По умолчанию: -

Контекст: http, server, location

Определяет условия для принудительной декомпрессии brotli. Если хотя бы одно значение в строковом параметре не пустое и не равно "0", выполняется принудительная декомпрессия zstd. Однако не будет предпринята попытка декомпрессии ответов, которые не содержат заголовок ответа Content-Encoding: zstd.

unzstd_buffers

Синтаксис: unzstd_buffers number size;

По умолчанию: unzstd_buffers 32 4k | 16 8k;

Контекст: http, server, location

Устанавливает количество и размер буферов, используемых для декомпрессии ответа. По умолчанию размер буфера равен одной странице памяти. Это либо 4K, либо 8K, в зависимости от платформы.

GitHub

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