Aller au contenu

keyval: module Nginx pour le stockage clé-valeur

Installation

Vous pouvez installer ce module dans toute 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-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

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

load_module modules/ngx_http_keyval_module.so;

Ce document décrit nginx-module-keyval v0.4.0 publié le 30 mars 2026.

Aperçu

nginx-keyval est un module dynamique de stockage clé-valeur pour nginx. Il a été développé en s'inspirant de la version commerciale du ngx_http_keyval_module de nginx.

Licence : Licence MIT

Caractéristiques Clés

  • Backend Double : Prend en charge deux types de backends de stockage : mémoire partagée (SHM) et Redis
  • Support HTTP / Stream : Fonctionne dans les contextes HTTP et Stream
  • Support TTL : Temps d'expiration configurable pour les paires clé-valeur
  • Clés Composites : Construisez des clés en combinant plusieurs variables et chaînes littérales (par exemple, $remote_addr:$http_user_agent)
  • Expansion de Variables : Utilisez des variables nginx comme clés, dynamiquement étendues à l'exécution

Démarrage Rapide

Voir INSTALL.md pour les instructions d'installation.

Exemple de Configuration Minimale

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

    server {
        listen 80;

        location / {
            return 200 $text;
        }
    }
}

Cette configuration récupère une valeur de la zone de mémoire partagée one en utilisant le paramètre de requête text comme clé, et la stocke dans la variable $text.

Directives

Directive Description Contexte
keyval Définit une variable à partir de paires clé-valeur http, stream
keyval_zone Définit une zone de mémoire partagée http, stream
keyval_zone_redis Définit une zone Redis http, stream

Voir DIRECTIVES.md pour une référence détaillée des directives.

Documentation Connexe

Configuration & Opérations : - DIRECTIVES.md : Référence des Directives - EXAMPLES.md : Exemples de Configuration - INSTALL.md : Instructions d'Installation - SECURITY.md : Directives de Sécurité - TROUBLESHOOTING.md : Guide de Dépannage

Référence : - COMMERCIAL_COMPATIBILITY.md : Compatibilité avec la Version Commerciale

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