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

Docker 容器之前的 Nginx 或 Caddy:自动 TLS 和 HTTP/3

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

分期

VPS 上运行多个容器:Next.js 在端口 3000 上,API 在 8080 上。我们需要一个反向代理,它接受 80 和 443、颁发和续订 Let's Encrypt 证书、提供 HTTP/2 和 HTTP/3 服务以及跨域代理。两个真正的候选者是 Caddy 和 Nginx。以下是两者的工作配置以及对各自故障位置的分析。

两者的共同点:仅发布代理。应用程序容器没有 ports 部分;代理通过撰写网络中的服务名称来访问它们。

Caddy:最低配置

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

这就够了。 Caddy 本身将接收 ACME 证书、更新证书、将 HTTP 重定向到 HTTPS 并启用 HTTP/3(在 Caddy 2 中默认启用,只需要转发的 UDP 端口)。 X-Forwarded-For 和 X-Forwarded-Proto 标头是自动设置的。

卷 caddy_data 至关重要。它包含证书和 ACME 帐户密钥。如果没有卷,每个重新创建的容器都会重新请求证书,并且通过频繁部署,您将遇到 Let's Encrypt 对单个域的发行限制。

Nginx:更多手动工作

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

不明显线条的解释:

  • listen 443 quic 和 http2 on 指令出现在分支 1.25 中。必须构建 HTTP/3 模块:检查​​ docker compose exec nginx nginx -V 2>&1 | grep -o http_v3_module。
  • reuseport 每个地址:端口对指定一次。在第二个server和quic中写listen 443 quic;,不加它,否则nginx将无法启动。
  • Alt-Svc 告诉浏览器服务器知道 HTTP/3。第一个请求始终通过 TCP 进行,下一个请求则通过 QUIC 进行。
  • resolver 127.0.0.11 和 proxy_pass 中的变量 - 解决经典问题。 Nginx 在启动时解析一次名称 web。如果容器被重新创建并收到新的IP,代理将继续向旧地址发送请求并返回502。使用变量时,名称将通过Docker内置的DNS进行解析并缓存10秒。如果没有这种相同的技术,如果 web 尚未引发:host not found in upstream,nginx 将根本无法启动。

证书是一项单独的任务:具有 webroot /var/www/certbot 的 certbot 容器、具有 /etc/letsencrypt 的共享卷以及定期续订,然后是 nginx -s reload。成功续订文件后,忘记重新加载是导致证书过期的常见原因。

基本比较

|问题 |球童 | nginx | |---|---|---| | TLS 发行和续订 |内置 |分别使用 certbot 或 acme.sh | | HTTP/3 |默认|需要模块和 listen quic | |重建容器|动态解析名称 |需要 resolver 和变量 | |缓存响应 |通过插件 |内联proxy_cache | |请求限制 |通过插件 |内置 limit_req、limit_conn | |论坛上现成的配置和答案 |少 |很多|

如何检查

# 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

在浏览器中,打开DevTools,Network选项卡并打开Protocol栏:再次加载后,应该有h3。

HTTP/3 通常出现故障的地方

  • UDP 443 关闭。在 compose 中打开端口还不够:检查 UFW (ufw allow 443/udp) 和提供商的云防火墙,其中 TCP 和 UDP 的规则是分开的。
  • Cloudflare 背后的网站启用了代理。然后,Cloudflare 终止浏览器的 HTTP/3,流量通过 TCP 发送到您的服务器。在 origin 上设置 QUIC 是没有意义的。
  • 企业网络正在削减 UDP。浏览器将回退到 HTTP/2,这是正常行为而不是错误。

选择什么

对于同一服务器上的多个服务没有特殊要求,Caddy 提供可用的 HTTPS 和 HTTP/3,且出错空间最小。如果您需要内置缓存、精简限制、您已经调试过配置或者团队非常了解,那么 Nginx 是合理的。小项目典型工作负载的性能取决于应用程序,而不是代理,因此不值得基于它进行选择。

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

Ещё на vbcd4u.com