Ce guide concerne NGINX Open Source. Vérifiez la version, les modules compilés ou chargés et les particularités de votre paquet.
Lire une configuration comme une arborescence
NGINX peut servir des fichiers, relayer des requêtes, répartir du trafic et utiliser un cache. Ces rôles sont déterminés par des directives placées dans leurs contextes. Une configuration se lit comme une arborescence ; l’ordre d’un fichier n’est pas un scénario d’exécution ligne par ligne.
Le contexte principal contient notamment les paramètres des processus. events décrit leur traitement des connexions. http contient la configuration HTTP, avec des blocs server puis location. Le contexte autorisé est une propriété de chaque directive, à vérifier dans sa référence.
Sources : NGINX / F5, Beginner’s Guide ; NGINX / F5, Core functionality ; NGINX / F5, Module ngx_http_core_module.
Identifier le fichier effectivement chargé
Le fichier principal et les répertoires inclus varient selon le paquet et les options de compilation. Ne présumez pas qu’un fichier placé dans un dossier sera lu. Un include insère les directives du fichier dans le contexte où il se trouve ; il ne donne pas automatiquement un contexte HTTP à un fragment.
nginx -V affiche les options de construction ; nginx -T vérifie et affiche les fichiers de configuration. Ce dernier peut révéler des informations sensibles. Un fichier sur disque peut encore différer de la configuration utilisée par les workers tant qu’un rechargement réussi n’a pas eu lieu.
nginx -V
sudo nginx -t
sudo nginx -TSources : NGINX / F5, Command-line parameters ; NGINX / F5, Controlling nginx.
Vérifier l’héritage directive par directive
Il n’existe pas une règle d’héritage unique applicable à toutes les directives. Certaines valeurs sont reprises du niveau parent si le niveau courant n’en définit aucune ; d’autres utilisent une liste ou un comportement particulier. La référence officielle reste nécessaire, notamment pour les en-têtes et les limites.
Pour expliquer un comportement, localisez le server choisi puis la location choisie, relevez les directives locales et recherchez les valeurs héritées. Un bloc visuellement proche dans le fichier peut concerner un autre hôte. La structure logique compte davantage que la proximité des lignes.
Sources : NGINX / F5, Module ngx_http_core_module ; NGINX / F5, Module ngx_http_proxy_module.
Exercice : un fichier qui ne change rien
Vous modifiez un fragment mais le service se comporte comme avant. Vérifiez le chemin de configuration utilisé, les includes, la validation syntaxique et le dernier rechargement. Indiquez ensuite quelle requête cible l’hôte et la location attendus ; ne changez pas plusieurs variables en même temps.
Le résultat attendu de cet exercice est un inventaire des fichiers et des contextes, pas une copie de la configuration dans un ticket public. Poursuivez avec le cycle de rechargement pour distinguer validation, signal et observation du service.
Sources : NGINX / F5, Command-line parameters ; NGINX / F5, Controlling nginx.
Sources et portée
Références consultées le . Les exemples utilisent des noms et adresses de documentation à remplacer. Les commandes de lecture affichent l’existant ; les captures et requêtes de diagnostic sont à limiter au périmètre autorisé.
- NGINX / F5 — Beginner’s Guide · Référence officielle ; vérifier le périmètre de version · consulté le 3 octobre 2026.
- NGINX / F5 — Core functionality · Référence officielle ; vérifier le périmètre de version · consulté le 3 octobre 2026.
- NGINX / F5 — Module ngx_http_core_module · Référence officielle ; vérifier le périmètre de version · consulté le 3 octobre 2026.
- NGINX / F5 — Command-line parameters · Référence officielle ; vérifier le périmètre de version · consulté le 3 octobre 2026.
- NGINX / F5 — Controlling nginx · Référence officielle ; vérifier le périmètre de version · consulté le 3 octobre 2026.
- NGINX / F5 — Module ngx_http_proxy_module · Référence officielle ; vérifier le périmètre de version · consulté le 3 octobre 2026.
Retrouver le parcours de lecture F5 NGINX