v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T09:25:00.000Z▲ 0 upvotes

Nginx ou Caddy avant les conteneurs Docker : TLS et HTTP/3 automatiques

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Mise en scène

Plusieurs conteneurs s'exécutent sur le VPS : Next.js sur le port 3000, API sur 8080. Nous avons besoin d'un proxy inverse qui accepte 80 et 443, émet et renouvelle les certificats Let's Encrypt, sert HTTP/2 et HTTP/3, ainsi que des proxys entre domaines. Deux vrais candidats sont Caddy et Nginx. Vous trouverez ci-dessous les configurations de travail des deux et une analyse des pannes de chacune.

Commun aux deux : seuls les proxys sont publiés. Les conteneurs d'applications n'ont pas de section ports ; le proxy leur parvient par le nom du service au sein du réseau de composition.

Caddy : configuration minimale

# compose.yml
services:
  caddy:
    image: caddy:2
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"   # HTTP/3 работает поверх QUIC, то есть UDP
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
      - caddy_data:/data
      - caddy_config:/config
  web:
    build: ./web
  api:
    build: ./api
volumes:
  caddy_data:
  caddy_config:
# Caddyfile
{
  email ops@example.com
}

example.com {
  encode zstd gzip
  reverse_proxy web:3000
}

api.example.com {
  reverse_proxy api:8080
}

www.example.com {
  redir https://example.com{uri} permanent
}

C'est assez. Caddy lui-même recevra les certificats ACME, les renouvellera, redirigera HTTP vers HTTPS et activera HTTP/3 (dans Caddy 2, il est activé par défaut, seul un port UDP transféré est nécessaire). Les en-têtes X-Forwarded-For et X-Forwarded-Proto sont définis automatiquement.

Le volume caddy_data est critique. Il contient des certificats et des clés de compte ACME. Sans volume, chaque conteneur recréé demande à nouveau des certificats, et avec des déploiements fréquents, vous rencontrerez les limites de version de Let's Encrypt pour un seul domaine.

Nginx : plus de travail manuel

# conf.d/example.conf
map $http_upgrade $connection_upgrade {
  default upgrade;
  ''      close;
}

server {
  listen 80;
  server_name example.com www.example.com;
  location /.well-known/acme-challenge/ { root /var/www/certbot; }
  location / { return 301 https://example.com$request_uri; }
}

server {
  listen 443 ssl;
  listen 443 quic reuseport;
  http2 on;
  server_name example.com;

  ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
  ssl_protocols TLSv1.2 TLSv1.3;

  add_header Alt-Svc 'h3=":443"; ma=86400' always;

  resolver 127.0.0.11 valid=10s;
  set $web http://web:3000;

  location / {
    proxy_pass $web;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
  }
}

Explications pour les lignes non évidentes :

  • listen 443 quic et la directive http2 on sont apparues dans la branche 1.25. Le module HTTP/3 doit être construit : vérifiez docker compose exec nginx nginx -V 2>&1 | grep -o http_v3_module.
  • reuseport est spécifié une fois par paire adresse:port. Dans le deuxième server avec quic écrivez listen 443 quic; sans cela, sinon nginx ne démarrera pas.
  • Alt-Svc indique au navigateur que le serveur connaît HTTP/3. La première requête passe toujours par TCP, les suivantes via QUIC.
  • resolver 127.0.0.11 et la variable dans proxy_pass - solution de contournement au problème classique. Nginx résout le nom web une fois au démarrage. Si le conteneur est recréé et reçoit une nouvelle adresse IP, le proxy continuera à envoyer des requêtes à l'ancienne adresse et renverra 502. Avec une variable, le nom est résolu via le DNS intégré de Docker et mis en cache pendant 10 secondes. Sans cette même technique, nginx ne démarrera pas du tout si web n'est pas encore levé : host not found in upstream.

Les certificats sont une tâche distincte : conteneur certbot avec webroot /var/www/certbot, volume partagé avec /etc/letsencrypt et renouvellement régulier suivi de nginx -s reload. Le rechargement oublié est une cause fréquente d'expiration d'un certificat lorsqu'un fichier a été renouvelé avec succès.

Comparaison essentielle

| Question | Caddie | Nginx | |---|---|---| | Émission et renouvellement de TLS | intégré | certbot ou acme.sh séparément | | HTTP/3 | par défaut | besoin d'un module et de listen quic | | Reconstruction des conteneurs | résout les noms de manière dynamique | besoin de resolver et d'une variable | | Mise en cache des réponses | via des plugins | en ligne proxy_cache | | Limites des demandes | via des plugins | limit_req intégré, limit_conn | | Configurations prêtes à l'emploi et réponses sur les forums | moins | beaucoup |

Comment vérifier

# HTTP/2 и заголовок Alt-Svc
curl -sI https://example.com | grep -iE "^HTTP|alt-svc"

# HTTP/3, если curl собран с его поддержкой
curl --http3-only -sI https://example.com | head -1

# Сертификат и срок действия
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null \
  | openssl x509 -noout -issuer -enddate

Dans le navigateur, ouvrez DevTools, onglet Réseau et activez la colonne Protocole : après un nouveau chargement, il devrait y avoir h3.

Là où HTTP/3 tombe généralement en panne

  • UDP 443 fermé. Ouvrir le port dans compose ne suffit pas : vérifiez UFW (ufw allow 443/udp) et le pare-feu cloud du fournisseur, où les règles pour TCP et UDP sont séparées.
  • Site Web derrière Cloudflare avec proxy activé. Ensuite, HTTP/3 avec le navigateur est terminé par Cloudflare et le trafic est dirigé vers votre serveur via TCP. Configurer QUIC sur Origin est inutile.
  • Les réseaux d'entreprise suppriment UDP. Le navigateur reviendra à HTTP/2, et il s'agit d'un comportement normal et non d'un bug.

Que choisir

Pour plusieurs services sur le même serveur sans exigences particulières, Caddy offre HTTPS et HTTP/3 fonctionnels avec le moins de marge d'erreur. Nginx est justifié si vous avez besoin d'un cache intégré, de limites fines, si vous avez déjà des configurations déboguées ou si l'équipe le sait bien. Les performances sur les charges de travail typiques d'un petit projet dépendent de l'application et non du proxy, cela ne vaut donc pas la peine de choisir en fonction de celui-ci.

Обсуждение (0)

Ещё на vbcd4u.com