HTTP/3基于QUIC传输协议，将TCP和TLS握手合并为一次往返，并在UDP上提供多路复用、连接迁移和更灵活的重传机制。对于Apache作为反向代理缓存的场景，启用HTTP/3意味着客户端可以通过QUIC与Apache建立连接，而Apache仍然使用HTTP/1.1或HTTP/2从后端源站获取内容，缓存后的响应再通过QUIC返回给客户端。这样做的一个直接好处是减少弱网环境下的建立连接时间，缓存命中后的响应可以更快地到达客户端。本文将围绕Apache 2.4.55及以上版本中实验性的mod_http3模块，介绍如何配置一个支持HTTP/3的代理缓存节点。
HTTP/3与代理缓存结合带来的实际收益
代理缓存的核心价值在于减少源站压力和降低客户端访问延迟。在传统TCP+TLS架构下，即使缓存命中，客户端仍然需要完成TCP三次握手和TLS握手，通常至少耗时两个RTT。QUIC通过0-RTT或1-RTT握手可以压缩这部分开销，尤其在移动网络或高丢包环境中，提升感受会更加明显。此外，QUIC的多路复用基于独立的流，不存在TCP队头阻塞问题，当一个缓存对象正在传输时，另一个小资源的响应不会因为前一个数据包丢失而被阻塞。
另一个常被忽略的优势是连接迁移。在移动设备切换Wi-Fi到蜂窝网络时，客户端的IP地址会发生变化，TCP连接必须重新建立，缓存代理需要重新解析请求。QUIC连接由连接ID而非四元组标识，可以在IP变化后继续使用同一个连接，从而避免重新握手和重新发送请求。对缓存代理而言，这意味着更低的连接重建频率，也间接提升了缓存命中后响应的一致性。
不过需要注意，HTTP/3的收益主要体现在客户端到Apache这一段。Apache与后端源站之间如果继续使用HTTP/1.1，那么后端的队头阻塞问题仍然存在。如果后端也支持HTTP/2或HTTP/3，可以进一步在代理层面配置协议协商，但本文聚焦于前端启用HTTP/3并配合磁盘缓存。
启用HTTP/3所需的模块与编译准备
Apache的HTTP/3支持由mod_http3模块提供，该模块目前仍处于实验状态，但已经可以在生产环境的测试节点中尝试使用。要编译mod_http3，Apache需要链接支持QUIC的SSL库，常见选择是OpenSSL 1.1.1及以上的分支，或者使用专门的quictls/OpenSSL fork。同时还需要nghttp3和ngtcp2两个库，分别处理HTTP/3层和QUIC传输层。编译Apache时需要显式启用相关选项，并确保mod_proxy、mod_cache、mod_cache_disk等模块一并编译。
以下是一个典型的编译配置示例，假设依赖库安装在/usr/local目录下：
./configure \ --enable-http3 \ --with-ssl=/usr/local/ssl \ --with-nghttp3=/usr/local \ --with-ngtcp2=/usr/local \ --enable-proxy \ --enable-proxy-http \ --enable-cache \ --enable-cache-disk \ --enable-headers \ --enable-deflate make make install
针对一些较老的Apache版本，社区提交中有一个编号为cyw43907的补丁改进了QUIC流控和窗口管理，如果在测试过程中遇到大文件传输中断或吞吐量异常，可以检查当前源码是否已经包含该补丁，或者在构建前手动应用对应的patch。这个补丁主要影响mod_http3在多流并发时的缓冲行为，对代理缓存大文件场景有一定帮助。
完成编译安装后，需要使用apachectl -M命令确认mod_http3、mod_proxy、mod_cache等模块已经加载。如果缺少模块，可以通过修改httpd.conf中的LoadModule指令来启用。
配置HTTP/3反向代理与磁盘缓存
在Apache中同时监听TCP 443和UDP 443是启用HTTP/3的关键一步。HTTP/3要求使用TLS，因此证书配置仍然基于传统的SSL模块。对于反向代理缓存，需要将代理请求转发到后端源站，同时对可缓存的内容启用磁盘缓存。以下是一个虚拟主机的完整配置示例：
Listen 443 http3
Listen 443 https
<VirtualHost *:443>
ServerName cache.ippipp.com
DocumentRoot "/var/www/html"
SSLEngine on
SSLCertificateFile "/etc/ssl/cache.ippipp.com.crt"
SSLCertificateKeyFile "/etc/ssl/cache.ippipp.com.key"
SSLProtocol -all +TLSv1.3
# HTTP/3 协议开关
Protocols h2 h3 http/1.1
# 反向代理配置
ProxyPreserveHost On
ProxyPass "/" "http://backend-origin.ippipp.com/"
ProxyPassReverse "/" "http://backend-origin.ippipp.com/"
# 磁盘缓存配置
CacheEnable disk /
CacheRoot "/var/cache/apache2/mod_cache_disk"
CacheDirLength 1
CacheDirLevels 2
CacheDefaultExpire 3600
CacheMaxExpire 86400
CacheIgnoreNoLastMod On
# HTTP/3 调优参数
H3MaxStreams 100
H3MaxData 10485760
H3MaxStreamData 1048576
# 告知客户端后续请求可尝试HTTP/3
Header set Alt-Svc 'h3=":443"; ma=86400'
ErrorLog "/var/log/apache2/cache_error.log"
CustomLog "/var/log/apache2/cache_access.log" combined
</VirtualHost>
配置中的Listen 443 http3和Listen 443 https可以共存，Apache会根据UDP或TCP自动选择对应的协议处理模块。Protocols指令用于在TLS握手中协商应用层协议，h3优先级放在h2之前，表示优先使用HTTP/3。Alt-Svc响应头则告诉客户端后续请求可以通过UDP 443直接使用HTTP/3，不必依赖首次协商。对于缓存部分，CacheEnable disk /启用磁盘缓存，CacheRoot指向缓存目录，需要保证该目录存在且httpd用户有写入权限。
需要注意的是，HTTP/3连接使用UDP，网络设备必须放行UDP 443端口。很多防火墙默认只开放TCP 443，如果客户端无法建立QUIC连接，可以先检查UDP端口是否可达。另外，某些负载均衡器或CDN可能不支持UDP转发，在真实部署时需要确认链路设备是否具备UDP负载均衡能力。
验证HTTP/3缓存命中与常见问题排查
配置完成后，可以使用curl命令测试HTTP/3连接。curl从7.66版本开始支持HTTP/3，但需要编译时启用HTTP/3支持。以下命令强制使用HTTP/3访问缓存节点：
curl -I --http3-only https://cache.ippipp.com/test.html
如果连接成功，curl会显示HTTP/3 200之类的响应行。同时可以检查响应头中是否包含Alt-Svc和缓存相关的头信息。为了确认缓存是否命中，可以在Apache的访问日志中增加缓存状态输出，或者在响应头中查看X-Cache头。以下是一个使用mod_headers添加X-Cache状态的配置片段：
<IfModule mod_cache.c>
Header set X-Cache "HIT" expr=%{CACHE_STATUS} == "hit"
Header set X-Cache "MISS" expr=%{CACHE_STATUS} == "miss"
</IfModule>
需要说明的是，CACHE_STATUS变量由mod_cache提供，在缓存模块处理完成后可用。该配置需要在虚拟主机或主配置中加载mod_headers，并确保表达式求值功能启用。
常见问题中，证书链不完整会导致QUIC握手失败，因为HTTP/3强制要求TLS 1.3。如果使用自签名证书，客户端可能因不信任而拒绝连接。另外，部分客户端对HTTP/3的支持还不够完善，测试时应使用最新版本的Chrome、Firefox或curl。如果Apache启动时提示mod_http3加载失败，通常是因为依赖库版本不匹配，需要重新编译依赖并确保LD_LIBRARY_PATH包含正确路径。对于性能问题，可以调整H3MaxData和H3MaxStreamData参数，增大单流和总体的流量控制窗口，避免大文件下载时出现窗口耗尽导致的停顿。
通过合理配置HTTP/3模块和代理缓存指令，可以让Apache在保持原有缓存功能的同时，为现代客户端提供更快的连接建立和更低的传输延迟。虽然HTTP/3目前仍在逐步普及，但在高延迟、高丢包的网络环境中，启用HTTP/3代理缓存已经能够带来可测量的性能提升。
Apache代理缓存HTTP/3QUIC修改时间：2026-08-30 10:03:29