Docker 容器之前的 Nginx 或 Caddy:自动 TLS 和 HTTP/3
分期
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 是合理的。小项目典型工作负载的性能取决于应用程序,而不是代理,因此不值得基于它进行选择。