Server blocks · Load balancing · Let's Encrypt & Certbot · Headers de sécurité
Bootcode IWA-S04 — DevOps, Semaine 4, Jour 1
1. Le rôle de Nginx
Architecture event-driven, serveur web et reverse proxy en production
2. Écrire des configs
server blocks et location blocks — la grammaire Nginx
3. Reverse proxy + load balancing
Nginx devant Node.js, upstream blocks et stratégies de répartition
4. HTTPS avec Let's Encrypt
Certbot : certificat SSL gratuit, automatisable, renouvelé tout seul
5. Sécuriser la config
Redirection HTTP → HTTPS, HSTS et headers de sécurité
Le contexte
Vos apps sont dockerisées et déployées — mais sur des ports custom, sans HTTPS
Nginx : architecture & configuration
Event-driven, fichiers, server blocks, location blocks
Reverse proxy & load balancing
Pourquoi Nginx devant Node.js — perf, sécurité, SSL termination
SSL/TLS : Let's Encrypt + Certbot
Certificats, chaînes, handshake — gratuit et automatisé
Live coding
Nginx reverse proxy HTTPS pour une app Node.js
Node.js ne doit JAMAIS être exposé directement en production.
⚡ Performance
Nginx sert les fichiers statiques et gère des milliers de connexions concurrentes en event-driven — Node.js garde son event loop pour la logique métier.
🛡️ Sécurité
Node écoute sur 127.0.0.1:3000 — invisible depuis l'extérieur. Nginx filtre, rate-limite et termine le TLS.
🔀 Répartition
Un seul point d'entrée port 443 : frontend statique + API + plusieurs instances Node en load balancing.
🔒 SSL termination
HTTPS déchiffré par Nginx — le trafic interne reste en HTTP local, l'app n'a pas à gérer les certificats.
# /etc/nginx/sites-available/bootcode-hub.conf
server {
listen 80;
server_name mon-domaine.com;
# frontend statique
root /var/www/bootcode-hub/dist;
location / {
try_files $uri $uri/ /index.html;
}
location /giraffe/ {
proxy_pass http://localhost:3000;
proxy_set_header Host $host;
}
}
server block
Un site virtuel : listen + server_name déterminent quelle config répond à quelle requête.
location block
Route par chemin : / vers les fichiers statiques, /giraffe/ proxifié vers Node.js.
try_files ... /index.html
SPA routing : si le fichier n'existe pas, servir index.html — React Router prend le relais.
sites-available ≠ sites-enabled
Le site vit dans sites-available/, activé par un lien symbolique dans sites-enabled/.
location /giraffe/ {
proxy_pass http://localhost:3000;
# transmettre le contexte réel de la requête
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
Host $host
Sans lui, le backend reçoit localhost — les redirections et le routing vhost côté app cassent.
X-Forwarded-For / Proto
L'IP réelle du client et le schéma (https) — sinon l'app voit 127.0.0.1 et croit être en HTTP.
⚠️ Piège classique : oublier proxy_set_header Host — bug subtil que tu chercheras des heures.
upstream backend {
least_conn;
server 127.0.0.1:3001;
server 127.0.0.1:3002;
server 127.0.0.1:3003;
}
server {
location /giraffe/ {
proxy_pass http://backend;
}
}
Un bloc upstream regroupe plusieurs serveurs — Nginx répartit le trafic.
round-robin (défaut) : chacun son tour
least_conn : vers le serveur le moins chargé
ip_hash : même client → même serveur (sessions)
Let's Encrypt : autorité de certification gratuite — les certificats coûtaient cher avant, aucune excuse aujourd'hui.
Certbot : le client qui obtient, installe et renouvelle automatiquement (les certificats expirent tous les 90 jours).
Le challenge ACME
Let's Encrypt prouve que tu contrôles le domaine via un fichier servi en HTTP — d'où la nécessité que le DNS pointe vers ton serveur avant.
# installer
sudo apt install certbot python3-certbot-nginx
# certificat + config Nginx auto
sudo certbot --nginx -d mon-domaine.com
# vérifier les certificats
sudo certbot certificates
# tester le renouvellement
sudo certbot renew --dry-run
# HTTP → HTTPS (obligatoire)
server {
listen 80;
server_name mon-domaine.com;
return 301 https://$host$request_uri;
}
# dans le block 443 :
add_header Strict-Transport-Security "max-age=31536000" always;
add_header X-Frame-Options "SAMEORIGIN" always;
add_header X-Content-Type-Options "nosniff" always;
add_header X-XSS-Protection "1; mode=block" always;
# cache longue durée pour les assets
location /assets/ {
expires 1y;
add_header Cache-Control "public, immutable";
}
HSTS
Le navigateur n'essaiera plus jamais HTTP sur ce domaine — protection contre le downgrade.
X-Frame-Options
Anti-clickjacking : ton site ne peut pas être iframé par un domaine tiers.
nosniff
Empêche le navigateur de deviner les types MIME — bloque une classe d'attaques.
❌ Oublier proxy_set_header Host
Le backend reçoit un mauvais Host — routing, redirects et génération d'URLs cassent.
❌ Config non activée / non rechargée
Le fichier doit être lié dans sites-enabled, puis nginx -t (test) et nginx -s reload (sans downtime).
❌ Certificat qui expire
Let's Encrypt = 90 jours. Sans certbot renew automatisé, ton site affiche une page d'erreur sécurité un beau matin.
❌ try_files oublié pour le SPA
Sans try_files $uri /index.html, rafraîchir /giraffe/login donne un 404 Nginx au lieu de laisser React Router gérer.
Exercice E4.1 — ~4h
Nginx devant le frontend React + backend Node.js, certificat Let's Encrypt, headers de sécurité et cache des assets.
À configurer
/ → build React + try_files SPA/giraffe/ → proxy_pass localhost:3000/assets/ → Cache-Control longChecklist
nginx -t passe, lien dans sites-enabledcurl -I)certbot renew --dry-run OK🚪 Nginx = la porte d'entrée
Node.js jamais exposé — Nginx sert les statiques, proxifie l'API, termine le TLS.
📋 server + location = la grammaire
sites-available → lien symbolique → sites-enabled. nginx -t avant tout reload.
🔒 HTTPS gratuit et automatique
Certbot + Let's Encrypt : un certificat en une commande, renouvelé tout seul.
🛡️ Les headers comptent
301 vers HTTPS, HSTS, X-Frame-Options — vérifiables sur securityheaders.com.