Nginx pour les développeurs : le guide de configuration que vous allez vraiment ajouter à vos favoris

Le modèle mental : Nginx, c'est comme un service du courrier

Configuration 1 : Next.js + Django derrière Nginx (la plus courante)

# Blocs « upstream » : définissez vos serveurs 
d'applicationupstream frontend {
    server frontend_container:3000;
    keepalive 16;  # réutilisation des connexions (gain de performances considérable)
}

upstream backend {
    server backend_container:8000;
    keepalive 8;
}

server {
    listen 443 ssl;
    server_name yourapp.com;

    # SSL (Let's Encrypt)
    ssl_certificate /etc/letsencrypt/live/yourapp.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourapp.com/privkey.pem;

    # Routes API -> Django
    location /api/ {
        proxy_pass http://backend;
        proxy_http_version 1.1;
        proxy_set_header Connection "";  # requis pour keepalive
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # Admin -> Django
    location /admin/ {
        proxy_pass http://backend;
        proxy_set_header Host $host;
    }

    # Fichiers statiques -> Django (avec mise en cache)
    location /static/ {
        proxy_pass http://backend;
        expires 30d;
        add_header Cache-Control "public, immutable";
    }

    # Tout le reste -> Next.js
    location / {
        proxy_pass http://frontend;
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        proxy_set_header Host $host;
        proxy_buffering off;  # important pour le streaming SSR
    }
}

Configuration 2 : Redirection HTTPS + URL canonique « www »

# Redirection HTTP vers HTTPSserver
 {
    listen 80;
    server_name yourapp.com www.yourapp.com;
    return 301 https://yourapp.com$request_uri;
}

# Redirection www vers 
non-wwwserver {
    listen 443 ssl;
    server_name www.yourapp.com;
    ssl_certificate /etc/letsencrypt/live/yourapp.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourapp.com/privkey.pem;
    return 301 https://yourapp.com$request_uri;
}

# Site principal (canonique)
server {
    listen 443 ssl;
    server_name yourapp.com;
    # ... votre configuration
}

Les 5 principes fondamentaux à connaître

Débogage : quand les choses tournent mal

# Commandes de débogage
 rapide nginx -t                    # Vérifier la syntaxe 
de la configuration nginx -s reload             # Recharger sans interruption de service
 tail -f /var/log/nginx/error.log   # Afficher les erreurs en temps 
réel curl -I https://yourapp.com  # Vérifier les en-têtes de réponse

Nginx, c'est le videur de votre boîte de nuit. C'est lui qui décide qui entre, où les clients vont et à quelle vitesse. Prenez 30 minutes pour le comprendre et vous gagnerez 30 heures de débogage en production.

— alokknight Ingénierie