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

Nginx ou Caddy antes dos contêineres Docker: TLS e HTTP/3 automáticos

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

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 quic e a diretiva http2 on apareceram no branch 1.25. O módulo HTTP/3 deve ser construído: verifique docker compose exec nginx nginx -V 2>&1 | grep -o http_v3_module.
  • reuseport é especificado uma vez por par endereço:porta. No segundo server com quic escreva listen 443 quic; sem ele, caso contrário o nginx não iniciará.
  • Alt-Svc informa 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.11 e a variável em proxy_pass - solução alternativa para o problema clássico. Nginx resolve o nome web uma 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á se web ainda 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.

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

Ещё на vbcd4u.com