Nginx ou Caddy antes dos contêineres Docker: TLS e HTTP/3 automáticos
Preparação
Vários contêineres são executados no VPS: Next.js na porta 3000, API na 8080. Precisamos de um proxy reverso que aceite 80 e 443, emita e renove certificados Let's Encrypt, sirva HTTP/2 e HTTP/3 e proxies entre domínios. Dois verdadeiros candidatos são Caddy e Nginx. Abaixo estão as configurações de trabalho de ambos e uma análise de onde cada um falha.
Comum a ambos: apenas proxies são publicados. Os contêineres de aplicativos não possuem uma seção ports; o proxy vai até eles pelo nome do serviço na rede composta.
Caddy: configuração mínima
# 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
}Isso é o suficiente. O próprio Caddy receberá certificados ACME, renova-los, redirecionará HTTP para HTTPS e habilitará HTTP/3 (no Caddy 2 está habilitado por padrão, apenas uma porta UDP encaminhada é necessária). Os cabeçalhos X-Forwarded-For e X-Forwarded-Proto são definidos automaticamente.
O volume caddy_data é crítico. Ele contém certificados e chaves de conta ACME. Sem um volume, cada contêiner recriado solicita certificados novamente e, com implantações frequentes, você atingirá os limites de lançamento do Let's Encrypt para um único domínio.
Nginx: mais trabalho manual
# 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;
}
}Explicações para linhas não óbvias:
listen 443 quice a diretivahttp2 onapareceram no branch 1.25. O módulo HTTP/3 deve ser construído: verifiquedocker compose exec nginx nginx -V 2>&1 | grep -o http_v3_module.reuseporté especificado uma vez por par endereço:porta. No segundoservercomquicescrevalisten 443 quic;sem ele, caso contrário o nginx não iniciará.Alt-Svcinforma ao navegador que o servidor conhece HTTP/3. A primeira solicitação sempre passa pelo TCP, as próximas pelo QUIC.resolver 127.0.0.11e a variável emproxy_pass- solução alternativa para o problema clássico. Nginx resolve o nomewebuma vez na inicialização. Se o contêiner for recriado e receber um novo IP, o proxy continuará enviando solicitações para o endereço antigo e retornando 502. Com uma variável, o nome é resolvido por meio do DNS integrado do Docker e armazenado em cache por 10 segundos. Sem esta mesma técnica, o nginx não iniciará sewebainda não tiver sido gerado:host not found in upstream.
Os certificados são uma tarefa separada: contêiner certbot com webroot /var/www/certbot, volume compartilhado com /etc/letsencrypt e renovação regular seguida de nginx -s reload. A recarga esquecida é uma causa comum de um certificado expirado quando um arquivo foi renovado com sucesso.
Comparação essencial
| Pergunta | Caddie | Nginx | |---|---|---| | Emissão e renovação de TLS | embutido | certbot ou acme.sh separadamente | | HTTP/3 | padrão | precisa de módulo e listen quic | | Reconstrução de contentores | resolve nomes dinamicamente | precisa de resolver e variável | | Respostas em cache | através de plug-ins | embutido proxy_cache | | Limites de solicitação | através de plug-ins | integrado limit_req, limit_conn | | Configurações prontas e respostas em fóruns | menos | muito |
Como verificar
# 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
No navegador, abra DevTools, aba Rede e ative a coluna Protocolo: após carregar novamente, deverá haver h3.
Onde o HTTP/3 geralmente falha
- UDP 443 fechado. Abrir a porta no compose não é suficiente: verifique o UFW (
ufw allow 443/udp) e o firewall da nuvem do provedor, onde as regras para TCP e UDP são separadas. - Site por trás do Cloudflare com proxy habilitado. Em seguida, o HTTP/3 com o navegador é encerrado pela Cloudflare e o tráfego vai para o seu servidor via TCP. Configurar o QUIC na origem é inútil.
- As redes corporativas estão cortando o UDP. O navegador voltará para HTTP/2, e este é um comportamento normal e não um bug.
O que escolher
Para vários serviços no mesmo servidor sem requisitos especiais, Caddy oferece HTTPS e HTTP/3 funcionais com o mínimo de espaço para erros. O Nginx se justifica se você precisar de um cache integrado, limites limitados, se já tiver configurações depuradas ou se a equipe conhece bem isso. O desempenho em cargas de trabalho típicas de um projeto pequeno depende do aplicativo, não do proxy, portanto não vale a pena escolher com base nele.