Aller au contenu

unbrotli: Décompresse les réponses encodées en Brotli pour les clients qui ne le supportent pas

Installation

Vous pouvez installer ce module dans n'importe quelle distribution basée sur RHEL, y compris, mais sans s'y limiter :

  • RedHat Enterprise Linux 7, 8, 9 et 10
  • CentOS 7, 8, 9
  • AlmaLinux 8, 9
  • Rocky Linux 8, 9
  • Amazon Linux 2 et 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

Activez le module en ajoutant ce qui suit en haut de /etc/nginx/nginx.conf :

load_module modules/ngx_http_unbrotli_filter_module.so;

Ce document décrit nginx-module-unbrotli v0.0.2 publié le 18 décembre 2024.

Le ngx_unbrotli est un module filtre qui décompresse les réponses encodées avec Brotli (Content-Encoding: br) pour les clients qui ne supportent pas Brotli. En stockant les réponses au format Brotli, vous pouvez économiser sur les coûts de stockage et d'I/O, et ce module garantit que les clients incapables de gérer Brotli reçoivent tout de même le contenu décompressé approprié.

Exemple de configuration

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

Directives de configuration

unbrotli

  • syntax: unbrotli on | off;
  • default: off
  • context: http, server, location

Active ou désactive la décompression des réponses compressées en Brotli (Content-Encoding: br) pour les clients qui ne supportent pas Brotli. Lorsque unbrotli est activé, le serveur vérifie les capacités du client (similaire à la gestion de gzip) pour déterminer si la décompression est nécessaire.

unbrotli_force

  • syntax: unbrotli_force on | off;
  • default: off
  • context: http, server, location

Force la décompression des réponses compressées en Brotli, même si le client indique qu'il supporte Brotli. Lorsque unbrotli_force est on, toutes les réponses encodées en Brotli sont décompressées avant d'être envoyées au client, quel que soit l'en-tête Accept-Encoding du client.

unbrotli_buffers

  • syntax: unbrotli_buffers number size;
  • default: dépend de la taille de la page système, communément : unbrotli_buffers 32 4k; ou unbrotli_buffers 16 8k;
  • context: http, server, location

Définit le nombre et la taille des buffers utilisés pour décompresser les réponses Brotli. En général, la taille équivaut à une page mémoire (4 Ko ou 8 Ko, selon la plateforme). Augmenter le nombre ou la taille de ces buffers peut améliorer les performances pour de grandes réponses au prix d'une utilisation mémoire plus élevée.

GitHub

Vous pouvez trouver des conseils de configuration supplémentaires et de la documentation pour ce module dans le dépôt GitHub pour nginx-module-unbrotli.