HTTP 与 Web 标准 / 系统课时

设计同时支持 h2 与 h3 的服务

设计同时支持 h2 与 h3 的服务

要把 HTTP/2 与 HTTP/3 同时上线,关键不是“开两个协议开关”,而是把 TLS 证书、TCP/UDP 监听、ALPN、Alt-Svc、代理转发和失败回退串成一条可验证的部署链路。本节给出一套面向生产环境的双协议结构,并明确客户端如何从 h2 平滑升级到 h3。

学习目标

  • 设计同时承载 h2 与 h3 的端口、证书和代理结构
  • 理解 ALPN 与 Alt-Svc 在协议选择中的不同职责
  • 建立可验证的 h3 失败回退与灰度上线策略

双协议部署结构

HTTP/2 运行在 TCP + TLS 上,HTTP/3 运行在 QUIC + UDP 上,因此同一个域名通常需要同时接受 TCP/443 与 UDP/443。两者可以复用同一张有效证书和同一业务入口,但底层监听必须分别存在,防火墙也要同时放行两种传输。

h2 与 h3 双协议部署结构

在边缘层使用支持 HTTP/3 的服务器或网关时,应先确认它真的启用了 QUIC/HTTP/3,而不是只支持 HTTP/2。以常见的 Nginx HTTP/3 构建为例,配置重点是同时保留 TLS 的 TCP 监听与 QUIC 的 UDP 监听,并在响应里发布 Alt-Svc。

下面是一个示意配置,具体指令是否可用取决于你的 Nginx 构建版本与编译模块,部署前应先用 nginx -V 和官方文档确认。

nginx
server {
    listen 443 ssl;
    listen 443 quic reuseport;
    http2 on;

    server_name example.com;

    ssl_certificate     /etc/nginx/certs/fullchain.pem;
    ssl_certificate_key /etc/nginx/certs/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;

    add_header Alt-Svc 'h3=":443"; ma=86400' always;

    location / {
        proxy_pass http://app_backend;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

该配置是配置片段示例,依赖已支持 QUIC/HTTP/3 的 Nginx 构建、有效证书和已定义的 app_backend 上游。生效后,TCP/443 继续服务 HTTPS 与 h2,UDP/443 承载 QUIC/h3,客户端可从响应头获知 h3 入口。

ALPN 与 Alt-Svc 分工

ALPN 用于 TLS 握手阶段协商应用层协议。客户端连到 TCP/443 时,可通过 ALPN 在支持的协议中选择 h2 或 http/1.1。HTTP/3 基于 QUIC,其协议协商发生在 QUIC/TLS 握手中,常见标识为 h3。

Alt-Svc 的作用不同。它不是握手内协商,而是服务器通过已有连接告诉客户端:“同一资源还可以通过另一个端点使用 h3”。因此首次访问完全可能先走 h2,收到 Alt-Svc 后,后续请求再尝试 h3。

验证 h2 与 h3

上线时至少分别验证 TCP 路径、UDP 路径和回退行为。先确认 h2 正常,再确认 h3,最后人为阻断 UDP,检查客户端是否仍能通过 TCP 访问。

若本机 curl 构建支持 HTTP/2,可以执行:

bash
curl -I --http2 https://example.com/

预期输出应能看到成功状态,并通常包含 Alt-Svc;具体服务器头字段可能不同。

text
HTTP/2 200
alt-svc: h3=":443"; ma=86400

若本机 curl 支持 HTTP/3,可以执行:

bash
curl -I --http3 https://example.com/

预期输出应显示 HTTP/3 成功响应:

text
HTTP/3 200
alt-svc: h3=":443"; ma=86400

实际头字段顺序和附加字段可能不同。若 curl --version 未显示 HTTP3 能力,则该验证命令不可用,应改用支持 HTTP/3 的客户端或浏览器开发工具。

代理、证书与网络边界

双协议方案最容易漏掉的是 UDP 链路。即使应用服务器已启用 h3,只要云安全组、宿主机防火墙、负载均衡器或前置 CDN 中任意一层未放行 UDP/443,客户端就无法完成 QUIC 连接。

证书方面,h2 与 h3 可以使用同一域名证书,但证书链必须完整,域名必须匹配,系统时间也要正确。若前置 CDN 或反向代理终止 TLS,则 h3 能力必须由最外层实际接收客户端流量的节点提供,后端是否使用 h3 是另一件事。

生产环境建议把观测维度拆开:h2 成功率、h3 成功率、h3 握手失败、QUIC 超时、回退到 h2 的比例。这样即使业务接口总体 200 正常,也能看出 HTTP/3 是否真的在工作。

回退与灰度策略

上线初期不要假设所有网络都允许 UDP。企业网络、老旧 NAT、防火墙策略或某些运营商链路都可能阻断 QUIC。因此双协议方案必须保留可靠的 TCP/h2 路径,HTTP/3 应当是可用时优先、失败时无损回退。

推荐先小范围启用 Alt-Svc,并缩短 ma,观察错误率与回退行为;稳定后再逐步延长缓存时间。出现 h3 异常时,可以先停止发布 Alt-Svc,让新请求继续稳定使用 h2,而不必同时关闭整个 HTTPS 服务。

最终验收标准不是“浏览器显示过 h3”,而是 TCP/443 与 UDP/443 都能按预期工作,h3 失败时业务仍可通过 h2 访问,并且监控能区分协议成功、失败与回退。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设计同时支持 h2 与 h3 的服务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通