Comment transformer Nginx en un serveur d'applications complet avec OpenResty

En matière de systèmes à forte charge, Nginx est généralement la première solution qui vient à l'esprit. Nous avons l'habitude de l'utiliser comme un proxy rapide ou un équilibreur de charge pratique. Mais que diriez-vous si je vous disais que Nginx peut exécuter une logique métier complexe, interroger des bases de données et mettre en cache des réponses directement « à l'intérieur » de lui-même, sans transmettre les requêtes à des backends lourds comme Python ou PHP ?

Découvrez OpenResty. Ce n'est pas simplement un ensemble de plugins, mais une plateforme web complète qui associe le cœur de Nginx à une collection de modules éprouvés en production et l'interpréteur LuaJIT.

Pourquoi aurions-nous besoin d'un autre serveur d'applications

D'ordinaire, le schéma fonctionne comme suit : Nginx reçoit une requête et l'envoie à un service. Le service accède à la base de données, effectue des calculs, puis renvoie la réponse à Nginx. À chaque étape, nous perdons de précieux millisecondes en sérialisation des données et en délais réseau entre les composants.

OpenResty propose une approche différente. Vous écrivez la logique en Lua — un langage reconnu pour sa simplicité et sa vitesse d'exécution grâce à la compilation JIT. Ainsi, le code s'exécute directement dans le contexte des processus worker de Nginx. Cela permet de gérer des dizaines et des centaines de milliers de requêtes par seconde sur du matériel ordinaire, sans alourdir l'infrastructure.

Ce qu'il y a d'intéressant dans le bundle

L'inspirateur visionnaire du projet, Yichun Zhang (agentzh), a accompli un travail considérable d'intégration de modules disparates. La valeur principale ici réside dans le fait que tous les composants sont garantis fonctionner ensemble.

L'une des fonctionnalités intéressantes mentionnées directement dans la documentation est le travail étendu avec le fichier système resolv.conf. Cela peut sembler anodin, mais Nginx standard nous oblige souvent à coder en dur les adresses IP du resolver dans la configuration. OpenResty peut récupérer les paramètres directement depuis le système ou tout autre fichier via la directive resolver. La syntaxe semble familière :

resolver local=on; # Использует /etc/resolv.conf
resolver local=/tmp/custom_dns.conf; # Или ваш кастомный файл

Cela simplifie la vie lors d'un changement dynamique de l'environnement réseau, par exemple dans des conteneurs Docker ou dans le cloud.

Les avantages pratiques de Lua dans Nginx

L'arme la plus puissante ici est le module ngx_lua. Avec lui, vous pouvez faire des choses qui nécessitaient auparavant l'écriture de modules C complexes.

Par exemple :

• Authentification dynamique : vérifiez un JWT ou accédez à Redis pour la session utilisateur avant que la requête n'atteigne le backend principal.
• Mise en cache intelligente : implémentez une logique complexe d'invalidation du cache ou stockez les données chaudes en mémoire partagée (shared dict) entre tous les workers Nginx.
• Agrégation de données : effectuez plusieurs requêtes parallèles vers différentes API et assemblez-les en une seule réponse JSON directement dans la couche proxy.

Le code Lua semble concis et se lit comme un script ordinaire, tout en ne bloquant pas la boucle d'événements de Nginx. Pendant qu'une requête attend une réponse de la base de données, le worker gère calmement les autres.

Qui profitera de cela

OpenResty a depuis longtemps dépassé le stade de « l'expérience de geek ». Il est utilisé par Cloudflare, Kong (une populaire API Gateway construite au-dessus d'OpenResty), et de nombreux grands fournisseurs de contenu.

Vous devriez y jeter un œil si :

• Vous avez atteint le plafond de performance de votre API Python, Ruby ou Node.js actuelle.
• Vous devez implémenter une logique de filtrage de trafic complexe ou un routage dynamique.
• Vous avez besoin de la couche de service de données la plus rapide possible depuis le cache.

Si vous êtes habitué à la configuration de Nginx, la barrière d'entrée sera minimale. Lua peut s'apprendre en une soirée, et vos capacités de gestion du trafic se multiplient considérablement.

Comment commencer

Le moyen le plus simple est de vous rendre sur le site officiel et de télécharger un package prêt à l'emploi pour votre OS. Pour ceux qui aiment tout contrôler, il existe un simple Makefile dans le dépôt. La compilation sur Fedora, par exemple, se résume à installer quelques dépendances (perl, dos2unix, mercurial) et à exécuter make. Ce faisant, vous obtenez non pas un « zoo » de modules, mais un outil monolithique, bien testé et prêt pour la production.

OpenResty est un cas où un vieil outil éprouvé acquiert des super-pouvoirs tout en restant fiable comme le roc. Si vous n'avez pas encore essayé d'écrire de la logique au niveau du proxy, c'est le moment idéal pour commencer.