Nginx lub Caddy przed kontenerami Docker: automatyczny TLS i HTTP/3
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 quici dyrektywahttp2 onpojawił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.reuseportjest określone raz na parę adres:port. W drugimserverzquicnapiszlisten 443 quic;bez niego, w przeciwnym razie nginx nie uruchomi się.Alt-Svcinformuje przeglądarkę, że serwer zna protokół HTTP/3. Pierwsze żądanie zawsze przechodzi przez TCP, kolejne przez QUIC.resolver 127.0.0.11i zmienna wproxy_pass- obejście klasycznego problemu. Nginx rozpoznaje nazwęwebraz 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śliwebnie 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.