Nginx o Caddy prima dei contenitori Docker: TLS e HTTP/3 automatici
Messa in scena
Diversi contenitori vengono eseguiti sul VPS: Next.js sulla porta 3000, API su 8080. Abbiamo bisogno di un proxy inverso che accetti 80 e 443, emetta e rinnovi i certificati Let's Encrypt, serva HTTP/2 e HTTP/3 e proxy tra domini. Due veri candidati sono Caddy e Nginx. Di seguito sono riportate le configurazioni di lavoro di entrambi e un'analisi dei punti in cui ciascuna si guasta.
Comune a entrambi: vengono pubblicati solo i proxy. I contenitori delle applicazioni non hanno una sezione ports; il proxy arriva a loro tramite il nome del servizio all'interno della rete di composizione.
Caddy: configurazione minima
# 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_CODICE]]
Questo è abbastanza. Caddy stesso riceverà i certificati ACME, li rinnoverà, reindirizzerà HTTP a HTTPS e abiliterà HTTP/3 (in Caddy 2 è abilitato per impostazione predefinita, è necessaria solo una porta UDP inoltrata). Le intestazioni X-Forwarded-For e X-Forwarded-Proto vengono impostate automaticamente.
Il volume caddy_data è fondamentale. Contiene certificati e chiavi dell'account ACME. Senza un volume, ogni contenitore ricreato richiede nuovamente i certificati e con distribuzioni frequenti ti imbatterai nei limiti di rilascio di Let's Encrypt per un singolo dominio.
Nginx: più lavoro manuale
[[VB_2_CODICE]]
Spiegazioni per linee non ovvie:
listen 443 quice la direttivahttp2 onsono apparse nel ramo 1.25. Il modulo HTTP/3 deve essere creato: controlladocker compose exec nginx nginx -V 2>&1 | grep -o http_v3_module.reuseportviene specificato una volta per ogni coppia indirizzo:porta. Nel secondoserverconquicscrivilisten 443 quic;senza di esso, altrimenti nginx non si avvierà.Alt-Svcdice al browser che il server conosce HTTP/3. La prima richiesta passa sempre tramite TCP, le successive tramite QUIC.resolver 127.0.0.11e la variabile inproxy_pass- soluzione alternativa al problema classico. Nginx risolve il nomewebuna volta all'avvio. Se il contenitore viene ricreato e riceve un nuovo IP, il proxy continuerà a inviare richieste al vecchio indirizzo e restituirà 502. Con una variabile, il nome viene risolto tramite il DNS integrato di Docker e memorizzato nella cache per 10 secondi. Senza questa stessa tecnica, nginx non si avvierà affatto sewebnon è ancora stato generato:host not found in upstream.
I certificati sono un'attività separata: contenitore certbot con webroot /var/www/certbot, volume condiviso con /etc/letsencrypt e rinnovo regolare seguito da nginx -s reload. Il ricaricamento dimenticato è una causa comune di un certificato scaduto quando un file è stato rinnovato con successo.
Confronto essenziale
| Domanda | Caddy | Nginx | |---|---|---| | Emissione e rinnovo TLS | integrato | certbot o acme.sh separatamente | | HTTP/3 | predefinito | è necessario il modulo e listen quic | | Ricostruzione container | risolve i nomi dinamicamente | è necessario resolver e la variabile | | Memorizzazione nella cache delle risposte | tramite plugin | in linea proxy_cache | | Limiti richiesta | tramite plugin | integrato limit_req, limit_conn | | Configurazioni e risposte già pronte sui forum | meno | molto |
Come verificare
[[VB_3_CODICE]]
Nel browser, apri DevTools, scheda Rete e attiva la colonna Protocollo: dopo aver caricato nuovamente, dovrebbe esserci h3.
Dove HTTP/3 solitamente non funziona
- UDP 443 chiuso. L'apertura della porta in composizione non è sufficiente: controlla UFW (
ufw allow 443/udp) e il firewall cloud del provider, dove le regole per TCP e UDP sono separate. - Sito web dietro Cloudflare con proxy abilitato. Quindi HTTP/3 con il browser viene terminato da Cloudflare e il traffico va al tuo server tramite TCP. L'impostazione di QUIC sull'origine è inutile.
- Le reti aziendali stanno tagliando l'UDP. Il browser tornerà a HTTP/2 e questo è un comportamento normale e non un bug.
Cosa scegliere
Per più servizi sullo stesso server senza requisiti speciali, Caddy fornisce HTTPS e HTTP/3 funzionanti con il minimo spazio per errori. Nginx è giustificato se hai bisogno di una cache integrata, limiti sottili, hai già configurazioni di debug o il team lo sa bene. Le prestazioni sui carichi di lavoro tipici di un piccolo progetto dipendono dall'applicazione, non dal proxy, quindi non vale la pena scegliere in base ad esso.