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.5.0 veröffentlicht am 15. Juni 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 des nginx ngx_http_keyval_module.
Lizenz: MIT-Lizenz
Hauptmerkmale
- Dual-Backend: Unterstützt zwei Arten von Speicher-Backends: gemeinsamen Speicher (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 Zeichenfolgen 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 gemeinsamen Speicherzone one ab, indem der Abfrageparameter text als Schlüssel verwendet wird, und speichert ihn in der Variablen $text.
Direktiven
| Direktive | Beschreibung | Kontext |
|---|---|---|
keyval |
Definiert eine Variable aus Schlüssel-Wert-Paaren | http, stream |
keyval_zone |
Definiert eine gemeinsame Speicherzone | http, stream |
keyval_zone_redis |
Definiert eine Redis-Zone | http, stream |
Siehe DIRECTIVES.md für eine detaillierte Direktivenreferenz.
Verwandte Dokumentation
Konfiguration & Betrieb: - DIRECTIVES.md: Direktivenreferenz - EXAMPLES.md: Konfigurationsbeispiele - INSTALL.md: Installationsanweisungen - SECURITY.md: Sicherheitsrichtlinien - TROUBLESHOOTING.md: Fehlerbehebungshandbuch
Referenz: - COMMERCIAL_COMPATIBILITY.md: Kompatibilität der kommerziellen Version
GitHub
Sie finden zusätzliche Konfigurationstipps und Dokumentationen für dieses Modul im GitHub-Repository für nginx-module-keyval.