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

Nginx of Caddy vóór Docker-containers: automatische TLS en HTTP/3

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

Staging

Er draaien verschillende containers op de VPS: Next.js op poort 3000, API op 8080. We hebben één reverse proxy nodig die 80 en 443 accepteert, Let's Encrypt-certificaten uitgeeft en vernieuwt, HTTP/2 en HTTP/3 bedient, en proxy's over domeinen heen. Twee echte kandidaten zijn Caddy en Nginx. Hieronder vindt u de werkende configuraties van beide en een analyse van waar beide kapot gaan.

Gemeenschappelijk voor beide: alleen proxy's worden gepubliceerd. Applicatiecontainers hebben geen sectie ports; de proxy gaat naar hen toe via de servicenaam binnen het compose-netwerk.

Caddy: minimale configuratie

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

Dat is genoeg. Caddy zelf zal ACME-certificaten ontvangen, deze vernieuwen, HTTP omleiden naar HTTPS en HTTP/3 inschakelen (in Caddy 2 is dit standaard ingeschakeld, alleen een doorgestuurde UDP-poort is nodig). De headers X-Forwarded-For en X-Forwarded-Proto worden automatisch ingesteld.

Volume caddy_data is van cruciaal belang. Het bevat certificaten en ACME-accountsleutels. Zonder volume vraagt ​​elke opnieuw gemaakte container opnieuw om certificaten, en bij frequente implementaties loop je tegen de releaselimieten van Let's Encrypt aan voor één domein.

Nginx: meer handmatig werk

# 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;
  }
}

Verklaringen voor niet voor de hand liggende lijnen:

  • listen 443 quic en de http2 on richtlijn verschenen in tak 1.25. De HTTP/3-module moet gebouwd worden: vink docker compose exec nginx nginx -V 2>&1 | grep -o http_v3_module aan.
  • reuseport wordt één keer opgegeven per adres:poortpaar. In de tweede server met quic schrijf je listen 443 quic; zonder, anders start nginx niet.
  • Alt-Svc vertelt de browser dat de server HTTP/3 kent. Het eerste verzoek gaat altijd via TCP, de volgende via QUIC.
  • resolver 127.0.0.11 en de variabele in proxy_pass - oplossing voor het klassieke probleem. Nginx lost de naam web één keer op bij het opstarten. Als de container opnieuw wordt gemaakt en een nieuw IP-adres ontvangt, blijft de proxy verzoeken naar het oude adres sturen en 502 retourneren. Met een variabele wordt de naam omgezet via de ingebouwde DNS van Docker en gedurende 10 seconden in de cache opgeslagen. Zonder deze zelfde techniek zal nginx helemaal niet starten als web nog niet is verhoogd: host not found in upstream.

Certificaten zijn een aparte taak: certbot container met webroot /var/www/certbot, gedeeld volume met /etc/letsencrypt en reguliere vernieuwing gevolgd door nginx -s reload. Vergeten opnieuw laden is een veel voorkomende oorzaak van een verlopen certificaat wanneer een bestand met succes is vernieuwd.

Essentiële vergelijking

| Vraag | Caddy | Nginx | |---|---|---| | TLS-uitgifte en -verlenging | ingebouwd | certbot of acme.sh afzonderlijk | | HTTP/3 | standaard | module nodig en listen quic | | Containers herbouwen | lost namen dynamisch op | heb resolver en variabele | nodig | Reacties in cache opslaan | via plug-ins | inline proxy_cache | | Limieten aanvragen | via plug-ins | ingebouwd limit_req, limit_conn | | Kant-en-klare configuraties en antwoorden op forums | minder | veel |

Hoe te controleren

# 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

Open in de browser DevTools, tabblad Netwerk en schakel de kolom Protocol in: na opnieuw laden zou er h3 moeten zijn.

Waar HTTP/3 meestal kapot gaat

  • UDP 443 gesloten. Het openen van de poort in compose is niet voldoende: controleer UFW (ufw allow 443/udp) en de cloudfirewall van de provider, waar de regels voor TCP en UDP gescheiden zijn.
  • Website achter Cloudflare met proxying ingeschakeld. Vervolgens wordt HTTP/3 met de browser beëindigd door Cloudflare en gaat het verkeer via TCP naar uw server. QUIC op oorsprong instellen is zinloos.
  • Bedrijfsnetwerken snijden UDP. De browser valt terug naar HTTP/2, en dit is normaal gedrag en geen bug.

Wat te kiezen

Voor meerdere services op dezelfde server zonder speciale vereisten biedt Caddy werkende HTTPS en HTTP/3 met de minste ruimte voor fouten. Nginx is gerechtvaardigd als je een ingebouwde cache en dunne limieten nodig hebt, als je al foutopsporing in de configuraties hebt of als het team dit goed weet. De prestaties bij typische workloads van een klein project zijn afhankelijk van de applicatie en niet van de proxy, dus het is niet de moeite waard om op basis daarvan te kiezen.

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

Ещё на vbcd4u.com