HTTP/3不再跑在TCP上，而是跑在QUIC（基于UDP）上，这让很多基于Apache搭建的代理缓存集群面临一个现实问题：Apache官方的httpd主线长期只支持到HTTP/2，代理层如果不升级，前端再怎么支持QUIC也到不了源站链路。好在Cloudflare开源了mod_http3这个模块，配合其Rust生态中的quiche与Pony相关实现，Apache完全可以获得HTTP/3的服务端与代理能力。本文将从一个实际代理缓存架构出发，完整讲清楚这条链路怎么打通。
一、先厘清几个容易混淆的概念：mod_http3、quiche和Pony到底是什么关系
很多文章把这几个词混着用，导致读者一头雾水。quiche是Cloudflare用Rust编写的QUIC与HTTP/3协议实现库，它同时支持QUIC v1和草案版本，也内置了对qlog等调试工具的支持。mod_http3则是构建在quiche之上的Apache模块，负责把QUIC流量接入Apache的请求处理流程，让httpd能够以HTTP/3的身份对外服务。
而Pony这一层更多指向Cloudflare在边缘代理场景中对高性能代理转发能力的实践，它的核心价值在于把QUIC的收发、流量转发与回源逻辑抽象成可复用的组件。对于我们自己的Apache代理缓存集群来说，理解Pony的意义在于借鉴其架构思想：在QUIC终结点做好协议转换，后端回源依然走传统的HTTP/1.1或h2c，缓存层完全无感知协议变化。
这一点非常关键：HTTP/3的复杂度应该被挡在边缘模块里，而不是侵入到mod_cache、mod_proxy的核心逻辑中。mod_http3的设计正是如此，它在Apache的process_connection钩子层拦截UDP流量，解析出HTTP/3帧后，重新组装成Apache内部熟悉的request_rec结构，后续的缓存判断、代理转发、日志记录全部沿用原有机制。
二、编译安装与基础配置：让Apache真正监听UDP 443
mod_http3目前需要从源码编译，官方httpd也尚未内置。编译的前提是准备Rust工具链和较新版本的httpd（建议2.4.48以上，因为需要用到较新的连接处理钩子）。典型流程如下：
# 安装Rust工具链 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh source $HOME/.cargo/env # 拉取mod_http3源码并编译 git clone https://github.com/cloudflare/mod_http3.git cd mod_http3 ./build.sh # 产物是一个动态模块，复制到Apache模块目录 cp .libs/mod_http3.so /usr/local/apache2/modules/
编译完成后，配置文件中需要同时开启TCP和UDP的监听。HTTP/3的握手依赖Alt-Svc机制：客户端先用HTTPS over TCP连接，服务器通过Alt-Svc响应头告知客户端可以用h3协议在同一个端口（或指定端口）尝试QUIC连接。配置示例如下：
LoadModule http3_module modules/mod_http3.so
LoadModule ssl_module modules/mod_ssl.so
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule cache_module modules/mod_cache.so
LoadModule cache_disk_module modules/mod_cache_disk.so
Protocols h2 h2c http/1.1 h3
Listen 443
Listen 443 udp
<VirtualHost *:443>
ServerName proxy.ipipp.com
SSLEngine on
SSLCertificateFile "/usr/local/apache2/conf/server.crt"
SSLCertificateKeyFile "/usr/local/apache2/conf/server.key"
# 通告HTTP/3能力
Header always set Alt-Svc 'h3=":443"; ma=86400'
# 代理缓存核心配置
CacheEnable disk /
CacheRoot "/var/cache/apache2"
CacheDirLevels 2
CacheDirLength 1
CacheDefaultExpire 3600
ProxyPreserveHost On
ProxyPass "/" "http://192.168.10.20:8080/"
ProxyPassReverse "/" "http://192.168.10.20:8080/"
</VirtualHost>
注意Protocols指令里要显式加上h3，否则即使模块加载成功，Apache也不会协商HTTP/3。另外UDP 443端口的防火墙规则经常被忽略，云服务器的安全组如果只放行了TCP 443，QUIC握手会直接超时，客户端会默默回退到TCP，表面看一切正常，实际HTTP/3根本没生效。
三、代理缓存链路分析：QUIC终结、缓存命中与回源行为
配置完成后，整条请求链路是这样的：客户端发起QUIC连接，mod_http3在UDP 443上完成QUIC握手与TLS 1.3握手（QUIC将传输层加密与TLS深度融合，握手比TCP+TLS快一到两个RTT），随后解封装HTTP/3帧，把请求交给Apache内部处理。
接下来的行为与普通HTTPS请求完全一致：mod_cache根据URI键查询磁盘缓存，命中且未过期则直接返回，状态码在日志中表现为缓存命中标记；未命中则由mod_proxy_http向源站发起回源请求。这里有一个值得强调的细节：回源连接默认走HTTP/1.1，你可以通过ProxyPass ... enablereuse=on启用连接复用，也可以对内部源站使用h2c避免多路复用开销。由于源站在内网，链路质量稳定，继续用HTTP/1.1或h2c回源是合理的选择，不必强求源站也升级HTTP/3。
缓存层面还有一个容易踩的坑：HTTP/3请求头采用QPACK压缩编码，这与HTTP/2的HPACK不同。不过这层差异被mod_http3完全屏蔽掉了，mod_cache拿到的已经是解压后的标准头，因此Vary、Cache-Control等缓存判定逻辑不需要任何改动。真正需要关注的是Alt-Svc头本身不要被缓存——如果它被缓存层原样存下来并返回给错误域名下的资源请求，会误导客户端。建议在缓存配置中显式处理：
<IfModule mod_headers.c>
# 确保Alt-Svc头动态生成，不受缓存干扰
Header onsuccess unset Alt-Svc
Header always set Alt-Svc 'h3=":443"; ma=86400'
</IfModule>
四、性能观察与验证：确认HTTP/3真的在工作
部署完成后，验证是必不可少的环节。最直接的方法是看Apache的访问日志，在LogFormat中加上%H变量可以输出协议版本，正常情况下你应该看到一部分请求的协议字段变成了HTTP/3。客户端侧也可以借助浏览器的开发者工具，Network面板的Protocol列会显示h3字样。
如果是命令行验证，curl从7.66版本开始支持HTTP/3，但通常需要自行编译开启：curl --http3 -I https://proxy.ipipp.com/。如果返回正常的响应头且响应中包含Alt-Svc通告，说明边缘侧已经就绪。再配合ngtcp2或浏览器内置的QUIC日志导出功能，可以进一步观察握手耗时、0-RTT恢复情况以及丢包恢复表现。
从实际测试经验看，HTTP/3带来的收益主要体现在弱网和高丢包场景。在内网低延迟环境下，QUIC相对h2的提升并不明显，甚至因为用户态UDP处理的额外开销略有下降。因此如果你的代理缓存集群服务的是移动端用户占比高的业务，HTTP/3的升级价值会更突出；反之可以保持灰度开启，通过Alt-Svc的ma参数控制切换节奏，逐步放量观察。
五、常见问题与稳定性建议
第一，模块成熟度问题。mod_http3目前仍标记为实验性质，生产环境建议先在边缘的少量节点灰度，并做好快速摘除UDP监听的预案。第二，内核UDP缓冲区默认值偏小，高并发QUIC流量下会出现丢包，建议通过sysctl -w net.core.rmem_max=16777216和wmem_max调大缓冲区，这与运行quiche其他应用的建议一致。
第三，监控层面要单独区分协议维度。由于HTTP/3流量走UDP，传统的TCP连接数监控无法覆盖，需要在日志分析中按协议分维度统计缓存命中率、回源比例和延迟分布，避免UDP侧的异常被平均数据掩盖。第四，证书管理完全不变，QUIC内嵌的TLS 1.3依然读取Apache标准证书配置，SNI行为也保持一致，这部分可以放心沿用现有自动化流程。
总体而言，借助mod_http3与quiche这套Rust实现，Apache代理缓存获得HTTP/3能力的门槛已经大幅降低。核心思路就是把QUIC终结在边缘模块，让缓存与回源逻辑保持协议无关，配合Alt-Svc灰度推进，既能吃到弱网场景的性能红利，又不会给现有缓存架构带来大的冲击。
Apache代理缓存HTTP/3mod_http3修改时间：2026-09-13 17:53:06