Comment utiliser : Générateur de configuration Nginx
- Choisissez le scénario : site statique, SPA (toutes les routes sont redirigées vers
index.html), proxy inverse vers une application sur un port, ou PHP-FPM. - Saisissez votre domaine, le répertoire racine des documents ou l'adresse en amont, puis choisissez la manière dont
wwwdoit être gérée. - Cochez les options supplémentaires : HTTPS avec les chemins Let’s Encrypt, gzip, mise en cache statique, en-têtes de sécurité, WebSockets, limitation de débit.
- Copiez le fichier de configuration, testez-le avec
nginx -tpuis relancez Nginx.
Ce qu'apporte chaque option
| Option | Directives |
|---|---|
| HTTPS | Serveur sur le port 80 qui redirige vers 301, listen 443 ssl, les chemins d’accès aux certificats Certbot et l’emplacement du défi ACME |
| SPA | try_files $uri $uri/ /index.html; afin que les routes côté client ne renvoient pas de code 404 |
| Proxy inverse | proxy_pass plus Host, X-Real-IP, X-Forwarded-For et X-Forwarded-Proto en-têtes |
| WebSockets | proxy_http_version 1.1 avec Upgrade / Connection en-têtes |
| gzip | Compression pour le texte, JSON, JS, CSS, SVG et les polices |
| Mise en cache statique | Durée de Cache-Control: immutable pour les ressources hachées, mise en cache de courte durée pour le HTML |
| En-têtes de sécurité | X-Content-Type-Options, Referrer-Policy, X-Frame-Options, Permissions-Policy |
| Limitation de débit | limit_req_zone (dans le http ) et limit_req avec une |
Obtention du certificat
Commencez par créer la configuration avec HTTPS désactivé, rechargez Nginx et exécutez sudo certbot certonly --webroot -w /var/www/letsencrypt -d example.com -d www.example.com — ou tout simplement sudo certbot --nginx. Activez ensuite HTTPS, rechargez, puis vérifiez le résultat à l’aide du vérificateur SSL, du vérificateur de redirection et du vérificateur d’en-têtes de sécurité.
Erreurs courantes
- Point-virgule manquant — chaque directive se termine par
;.nginx -tindique la ligne exacte. - Héritage d’`add_header` — une
add_headerà l’intérieur d’unlocationremplace tous les en-têtes au niveau du serveur. Le générateur répète les en-têtes de sécurité si nécessaire. - Barre oblique finale dans proxy_pass —
proxy_pass http://app/;supprime le préfixe d’emplacement,proxy_pass http://app;le conserve. - Types MIME incorrects — polices ou
.webmanifestservies en tant queapplication/octet-stream; vérifiez-les à l’aide de l’outil de recherche de types MIME.
Vous utilisez Docker ? Associez-le au générateur Docker Compose.
Aussi recherché comme : configuration du proxy inverse nginx, configuration de nginx spa, bloc de serveur nginx, redirection https avec nginx, proxy websocket nginx, configuration de nginx et php-fpm, redirection « www » avec nginx.
Outils complémentaires : Générateur de configuration Nginx
- Générateur de VirtualHost Apache — Obtenez une configuration complète d’hôte virtuel Apache pour votre domaine : site statique, WordPress, PHP-FPM ou proxy inverse vers une application Node ou Python.
- Générateur de Caddyfile — Caddy obtient automatiquement les certificats HTTPS : vous ne faites que décrire votre site.
- Validateur YAML — Collez un fichier Docker Compose, un manifeste Kubernetes, un workflow GitHub Actions ou tout autre YAML pour localiser les erreurs, repérer les pièges courants et obtenir une version proprement formatée.
- Générateur YAML Kubernetes — Renseignez le nom, l’image et le port de votre application pour obtenir du YAML Kubernetes prêt pour la production : un Deployment avec sondes, limites de ressources et contexte de sécurité renforcé, ainsi que le Service, l’Ingress avec TLS, le ConfigMap, le Secret et le HorizontalPodAutoscaler que vous cochez, le tout dans un seul fichier prêt pour kubectl apply.
Questions fréquentes
Comment puis-je tester une configuration Nginx avant de la recharger ?
Exécutez la commande « sudo nginx -t ». Elle vérifie la syntaxe et les chemins d'accès aux fichiers, puis affiche la ligne où se trouve l'erreur éventuelle. Ne relancez le service (sudo systemctl reload nginx) que lorsque le message « syntax is ok » et « test is successful » s'affiche.
Comment faire en sorte qu’une application React ou Vue continue de fonctionner lors de l’actualisation de la page ?
Utilisez le scénario SPA. Il ajoute la ligne « try_files $uri $uri/ /index.html ; », de sorte que tout chemin inconnu renvoie la page index.html et que le routeur côté client prend le relais.
Où est stockée la variable « limit_req_zone » ?
La directive `limit_req_zone` doit figurer dans le contexte http (par exemple dans /etc/nginx/nginx.conf ou en début d'un fichier qui y est inclus), et non à l'intérieur de la section `server`. Le générateur la place en début de fichier avec un commentaire ; les fichiers du répertoire `sites-enabled` sont inclus par défaut dans le contexte http.
Dois-je activer le protocole HSTS ?
Uniquement si le protocole HTTPS fonctionne sur le domaine et tous les sous-domaines que vous incluez. Les navigateurs mémorisent le HSTS pendant la durée « max-age » ; ainsi, un certificat invalide rendra le site inaccessible. Commencez par définir une durée « max-age » courte.
Puis-je installer Générateur de configuration Nginx en tant qu’application web et l’utiliser hors ligne ?
Oui. Générateur de configuration Nginx est une application web installable (PWA) : elle s’installe depuis votre navigateur, sans passer par une boutique d’applications. Cliquez sur « Installer l’application » en haut de cette page dans Chrome ou Edge (Windows, macOS, Linux, ChromeOS) ; sur Android, utilisez « Partager » → « Ajouter à l’écran d’accueil » sur iPhone et iPad ; ou « Fichier » → « Ajouter au Dock » dans Safari 17+ sur Mac. L’application s’ouvre alors dans sa propre fenêtre avec sa propre icône, et comme elle s’exécute entièrement dans votre navigateur, elle continue de fonctionner hors ligne. Firefox sur ordinateur de bureau ne permet pas d’installer d’applications web. Comment fonctionne l’installation.