Zum Inhalt

keyval: Nginx-Modul für den Schlüssel-Wert-Speicher

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-keyval

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-keyval

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

load_module modules/ngx_http_keyval_module.so;

Dieses Dokument beschreibt nginx-module-keyval v0.4.0, veröffentlicht am 30. März 2026.

Übersicht

nginx-keyval ist ein dynamisches Modul für einen Schlüssel-Wert-Speicher für nginx. Es wurde inspiriert von der kommerziellen Version von nginxs ngx_http_keyval_module.

Lizenz: MIT Lizenz

Hauptmerkmale

  • Dual-Backend: Unterstützt zwei Arten von Speicher-Backends: Shared Memory (SHM) und Redis
  • HTTP / Stream Unterstützung: Funktioniert sowohl im HTTP- als auch im Stream-Kontext
  • TTL Unterstützung: Konfigurierbare Ablaufzeit für Schlüssel-Wert-Paare
  • Zusammengesetzte Schlüssel: Erstellen Sie Schlüssel, indem Sie mehrere Variablen und Literale kombinieren (z. B. $remote_addr:$http_user_agent)
  • Variablenexpansion: Verwenden Sie nginx-Variablen als Schlüssel, die zur Laufzeit dynamisch erweitert werden

Schnellstart

Siehe INSTALL.md für Installationsanweisungen.

Minimales Konfigurationsbeispiel

http {
    keyval_zone zone=one:32k;
    keyval $arg_text $text zone=one;

    server {
        listen 80;

        location / {
            return 200 $text;
        }
    }
}

Diese Konfiguration ruft einen Wert aus der Shared Memory-Zone one ab, indem der Abfrageparameter text als Schlüssel verwendet wird, und speichert ihn in der Variablen $text.

Direktiven

Direktive Beschreibung Kontext
keyval Definieren Sie eine Variable aus Schlüssel-Wert-Paaren http, stream
keyval_zone Definieren Sie eine Shared Memory-Zone http, stream
keyval_zone_redis Definieren Sie eine Redis-Zone http, stream

Siehe DIRECTIVES.md für eine detaillierte Referenz zu den Direktiven.

Verwandte Dokumentation

Konfiguration & Betrieb: - DIRECTIVES.md: Direktivenreferenz - EXAMPLES.md: Konfigurationsbeispiele - INSTALL.md: Installationsanweisungen - SECURITY.md: Sicherheitsrichtlinien - TROUBLESHOOTING.md: Fehlersuche

Referenz: - COMMERCIAL_COMPATIBILITY.md: Kompatibilität mit der kommerziellen Version

GitHub

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