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

Nginx lub Caddy przed kontenerami Docker: automatyczny TLS i HTTP/3

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

Inscenizacja

Na VPS działa kilka kontenerów: Next.js na porcie 3000, API na 8080. Potrzebujemy jednego odwrotnego proxy, które akceptuje 80 i 443, wystawia i odnawia certyfikaty Let's Encrypt, obsługuje HTTP/2 i HTTP/3 oraz proxy w różnych domenach. Dwoma prawdziwymi kandydatami są Caddy i Nginx. Poniżej znajdują się działające konfiguracje obu rozwiązań oraz analiza miejsc awarii każdego z nich.

Wspólne dla obu: publikowane są tylko proxy. Kontenery aplikacji nie mają sekcji ports; serwer proxy łączy się z nimi według nazwy usługi w sieci tworzenia.

Caddy: minimalna konfiguracja

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

[[VB_1_KOD]]

To wystarczy. Caddy sam otrzyma certyfikaty ACME, odnowi je, przekieruje HTTP na HTTPS i włączy HTTP/3 (w Caddy 2 jest on domyślnie włączony, potrzebny jest jedynie przekierowany port UDP). Nagłówki X-Forwarded-For i X-Forwarded-Proto są ustawiane automatycznie.

Wolumin caddy_data jest krytyczny. Zawiera certyfikaty i klucze do kont ACME. Bez wolumenu każdy odtworzony kontener żąda certyfikatów od nowa, a przy częstych wdrożeniach natkniesz się na limity wersji Let's Encrypt dla pojedynczej domeny.

Nginx: więcej pracy ręcznej

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

Objaśnienia dla nieoczywistych linii:

  • listen 443 quic i dyrektywa http2 on pojawiły się w gałęzi 1.25. Należy zbudować moduł HTTP/3: sprawdź docker compose exec nginx nginx -V 2>&1 | grep -o http_v3_module.
  • reuseport jest określone raz na parę adres:port. W drugim server z quic napisz listen 443 quic; bez niego, w przeciwnym razie nginx nie uruchomi się.
  • Alt-Svc informuje przeglądarkę, że serwer zna protokół HTTP/3. Pierwsze żądanie zawsze przechodzi przez TCP, kolejne przez QUIC.
  • resolver 127.0.0.11 i zmienna w proxy_pass - obejście klasycznego problemu. Nginx rozpoznaje nazwę web raz przy uruchomieniu. Jeśli kontener zostanie odtworzony i otrzyma nowy adres IP, serwer proxy będzie nadal wysyłał żądania na stary adres i zwróci 502. W przypadku zmiennej nazwa zostanie rozpoznana przez wbudowany DNS Dockera i buforowana przez 10 sekund. Bez tej samej techniki nginx w ogóle się nie uruchomi, jeśli web nie zostanie jeszcze podniesione: host not found in upstream.

Certyfikaty to osobne zadanie: kontener certbota z webrootem /var/www/certbot, wolumen współdzielony z /etc/letsencrypt i regularne odnawianie, po którym następuje nginx -s reload. Zapomniane ponowne załadowanie jest częstą przyczyną wygaśnięcia certyfikatu po pomyślnym odnowieniu pliku.

Niezbędne porównanie

| Pytanie | Caddy | Nginx | |---|---|---| | Wydanie i odnowienie protokołu TLS | wbudowany | certbot lub acme.sh oddzielnie | | HTTP/3 | domyślny | potrzebny moduł i listen quic | | Odbudowa kontenerów | dynamicznie rozwiązuje nazwy | potrzebujesz resolver i zmiennej | | Buforowanie odpowiedzi | poprzez wtyczki | wbudowany proxy_cache | | Limity żądań | poprzez wtyczki | wbudowany limit_req, limit_conn | | Gotowe konfiguracje i odpowiedzi na forach | mniej | dużo |

Jak sprawdzić

# 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

W przeglądarce otwórz DevTools, zakładkę Sieć i włącz kolumnę Protokół: po ponownym załadowaniu powinien pojawić się h3.

Gdzie zwykle następuje awaria protokołu HTTP/3

  • UDP 443 zamknięty. Otwarcie portu w Compose nie wystarczy: sprawdź UFW (ufw allow 443/udp) i zaporę sieciową dostawcy, gdzie reguły dla TCP i UDP są oddzielne.
  • Witryna internetowa Cloudflare z włączoną obsługą proxy. Następnie protokół HTTP/3 w przeglądarce jest kończony przez Cloudflare, a ruch kierowany jest do Twojego serwera poprzez TCP. Konfigurowanie QUIC na Origin jest bezcelowe.
  • Sieci korporacyjne rezygnują z protokołu UDP. Przeglądarka powróci do protokołu HTTP/2 i jest to normalne zachowanie, a nie błąd.

Co wybrać

W przypadku wielu usług na tym samym serwerze bez specjalnych wymagań Caddy zapewnia działające protokoły HTTPS i HTTP/3 z najmniejszą ilością miejsca na błędy. Nginx jest uzasadniony, jeśli potrzebujesz wbudowanej pamięci podręcznej, cienkich limitów, masz już debugowane konfiguracje lub zespół dobrze o tym wie. Wydajność na typowych obciążeniach małego projektu zależy od aplikacji, a nie od serwera proxy, więc nie warto wybierać w oparciu o to.

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

Ещё на vbcd4u.com