Dans l'architecture logicielle moderne, Nginx s'est imposé comme un composant indispensable. Que ce soit pour masquer l'infrastructure interne, répartir la charge de travail ou sécuriser les échanges, sa maîtrise est essentielle pour tout ingénieur système ou développeur backend.

1. Architecture fondamentale du fichier de configuration

La configuration de Nginx (généralement située dans /etc/nginx/nginx.conf) repose sur une structure hiérarchique par blocs. Voici une décomposition des sections principales :

# Paramètres globaux
user web_admin;
worker_processes auto;

events {
    # Nombre maximal de connexions simultanées par worker
    worker_connections 2048;
}

http {
    include /etc/nginx/mime.types;
    default_type application/octet-stream;

    # Formatage des logs personnalisés
    log_format technical_log '$remote_addr - $remote_user [$time_local] '
                             '"$request" $status $body_bytes_sent '
                             '"$http_referer" "$http_user_agent"';

    access_log /var/log/nginx/access_web.log technical_log;

    # Optimisation de la compression
    gzip on;
    gzip_comp_level 5;
    gzip_types text/plain application/javascript text/css application/json;

    # Bloc de définition des serveurs d'application
    upstream app_cluster {
        server 10.0.0.1:9000;
        server 10.0.0.2:9000;
    }

    # Définition de l'hôte virtuel
    server {
        listen 80;
        server_name mon-application.fr;

        # Gestion des fichiers statiques
        location / {
            root /var/www/html/dist;
            index index.html;
            try_files $uri $uri/ /index.html;
        }

        # Proxy vers le backend
        location /api/ {
            proxy_pass http://app_cluster/;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
    }
}

2. Scénarios d'utilistaion et configurations pratiques

Déploiement d'applications découplées (Frontend & Backend)

Pour un projet utilisant un framework comme Vue ou React avec une API backend, la gestion des chemins est critique. L'utilisation du caractère / à la fin du proxy_pass modifie le comportement de transfert :

server {
    listen 80;
    server_name api.domaine.com;

    location /v1/ {
        # Avec le slash final, /v1/user devient /user sur le backend
        proxy_pass http://127.0.0.1:3000/;
        proxy_set_header Host $host;
    }
}

Équilibrage de charge (Load Balancing)

Nginx permet de distribuer le trafic entre plusieurs instances pour assurer la haute disponibilité.

upstream backend_cluster {
    # Stratégie par défaut : Round Robin
    server srv-node-01:8080 weight=5; # Reçoit 5 fois plus de trafic
    server srv-node-02:8080;
    server srv-node-03:8080 backup;   # Utilisé uniquement si les autres échouent
}

server {
    listen 80;
    location /services/ {
        proxy_pass http://backend_cluster;
        proxy_connect_timeout 10s;
    }
}

Sécurisation via HTTPS

La redirection automatique du trafic non sécurisé vers le port 443 est une norme de sécurité de base.

# Redirection HTTP vers HTTPS
server {
    listen 80;
    server_name secure.domaine.com;
    return 301 https://$server_name$request_uri;
}

# Configuration SSL
server {
    listen 443 ssl;
    server_name secure.domaine.com;

    ssl_certificate /etc/letsencrypt/live/domaine.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/domaine.com/privkey.pem;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    location / {
        proxy_pass http://127.0.0.1:8080;
    }
}

Limitation de débit (Rate Limiting)

Pour protéger vos points d'entrée sensibles contre les attaques par force brute ou le scraping intensif :

# Zone de mémoire pour stocker les états des IP (10 Mo)
limit_req_zone $binary_remote_addr zone=security_policy:10m rate=5r/s;

server {
    location /api/auth/ {
        # Autorise des rafales de 10 requêtes maximum
        limit_req zone=security_policy burst=10 nodelay;
        proxy_pass http://backend_auth;
    }
}

3. Erreurs courantes et optimisation

De nombreux problèmes de production proviennent de mauvaises configurations des en-têtes ou d'une gestion inefficace du cache.

• Perte de l'IP réelle : Sans proxy_set_header X-Real-IP, votre application verra l'IP de Nginx au lieu de celle du client final.
• Absence de cache statique : Pour améliorer les performances, définissez des politiques d'expiration pour les ressources immuables.

location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
    expires 30d;
    add_header Cache-Control "public, no-transform";
}

4. Synthèse des directives essentielles

Avant chaque déploiement, vérifiez toujours l'intégrité de votre fichier avec la commande nginx -t. Une fois validée, appliquez les changements sans interruption de service via nginx -s reload.