Nginx ou Caddy avant les conteneurs Docker : TLS et HTTP/3 automatiques
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 quicet la directivehttp2 onsont apparues dans la branche 1.25. Le module HTTP/3 doit être construit : vérifiezdocker compose exec nginx nginx -V 2>&1 | grep -o http_v3_module.reuseportest spécifié une fois par paire adresse:port. Dans le deuxièmeserveravecquicécrivezlisten 443 quic;sans cela, sinon nginx ne démarrera pas.Alt-Svcindique 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.11et la variable dansproxy_pass- solution de contournement au problème classique. Nginx résout le nomwebune 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 siwebn'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.