Nginx, reverse proxy & HTTPS

Server blocks · Load balancing · Let's Encrypt & Certbot · Headers de sécurité

Bootcode IWA-S04 — DevOps, Semaine 4, Jour 1

Objectifs de la leçon

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é

Plan du cours

1

Le contexte

Vos apps sont dockerisées et déployées — mais sur des ports custom, sans HTTPS

2

Nginx : architecture & configuration

Event-driven, fichiers, server blocks, location blocks

3

Reverse proxy & load balancing

Pourquoi Nginx devant Node.js — perf, sécurité, SSL termination

4

SSL/TLS : Let's Encrypt + Certbot

Certificats, chaînes, handshake — gratuit et automatisé

5

Live coding

Nginx reverse proxy HTTPS pour une app Node.js

Pourquoi Nginx devant 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.

Anatomie d'une config Nginx

# /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/.

proxy_pass : les headers qui sauvent

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.

Load balancing avec upstream

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)

HTTPS avec Let's Encrypt & Certbot

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

Redirection HTTPS + headers de sécurité

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

Pièges courants

❌ 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

Reverse proxy HTTPS pour Bootcode Hub

Nginx devant le frontend React + backend Node.js, certificat Let's Encrypt, headers de sécurité et cache des assets.

À configurer

  • 1️⃣ Server block 80 → 301 vers HTTPS
  • 2️⃣ Server block 443 + certificats SSL
  • 3️⃣ / → build React + try_files SPA
  • 4️⃣ /giraffe/ → proxy_pass localhost:3000
  • 5️⃣ /assets/ → Cache-Control long
  • 6️⃣ Headers : HSTS, X-Frame-Options, nosniff

Checklist

  • ✅ nginx -t passe, lien dans sites-enabled
  • ✅ HTTP → 301 HTTPS (curl -I)
  • ✅ Frontend accessible en HTTPS
  • ✅ /giraffe/ proxifié vers Node
  • ✅ certbot renew --dry-run OK
  • ✅ securityheaders.com → bonne note

À retenir !

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