Zum Inhalt

unbrotli: Dekomprimiert Brotli-kodierte Antworten für Clients, die es nicht unterstützen

Installation

Sie können dieses Modul in jeder RHEL-basierten Distribution installieren, einschließlich, aber nicht beschränkt auf:

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

Aktivieren Sie das Modul, indem Sie Folgendes an den Anfang von /etc/nginx/nginx.conf hinzufügen:

load_module modules/ngx_http_unbrotli_filter_module.so;

Dieses Dokument beschreibt nginx-module-unbrotli v0.0.2 veröffentlicht am 18. Dezember 2024.

Das ngx_unbrotli ist ein Filtermodul, das Antworten, die mit Brotli kodiert sind (Content-Encoding: br), für Clients, die Brotli nicht unterstützen, dekomprimiert. Durch die Speicherung von Antworten im Brotli-Format können Sie Speicher- und I/O-Kosten sparen, und dieses Modul stellt sicher, dass Clients, die Brotli nicht verarbeiten können, dennoch den entsprechenden dekomprimierten Inhalt erhalten.

Beispielkonfiguration

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

Konfigurationsanweisungen

unbrotli

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

Aktiviert oder deaktiviert die Dekompression von Brotli-komprimierten (Content-Encoding: br) Antworten für Clients, die Brotli nicht unterstützen. Wenn unbrotli aktiviert ist, überprüft der Server die Fähigkeiten des Clients (ähnlich wie bei der Verarbeitung von gzip), um festzustellen, ob eine Dekompression erforderlich ist.

unbrotli_force

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

Zwingt die Dekompression von Brotli-komprimierten Antworten, selbst wenn der Client Unterstützung für Brotli angibt. Wenn unbrotli_force auf on gesetzt ist, werden alle Brotli-kodierten Antworten dekomprimiert, bevor sie an den Client gesendet werden, unabhängig vom Accept-Encoding-Header des Clients.

unbrotli_buffers

  • syntax: unbrotli_buffers number size;
  • default: hängt von der Seitengröße des Systems ab, üblicherweise: unbrotli_buffers 32 4k; oder unbrotli_buffers 16 8k;
  • context: http, server, location

Legt die Anzahl und Größe der Puffer fest, die für die Dekompression von Brotli-Antworten verwendet werden. Typischerweise entspricht die Größe einer Speicherseite (4 KB oder 8 KB, abhängig von der Plattform). Die Erhöhung der Anzahl oder Größe dieser Puffer kann die Leistung bei großen Antworten verbessern, geht jedoch mit einem höheren Speicherverbrauch einher.

GitHub

Sie finden möglicherweise zusätzliche Konfigurationstipps und Dokumentationen für dieses Modul im GitHub-Repository für nginx-module-unbrotli.