将Apache作为反向代理缓存节点时，通常会在443端口终止TLS并转发请求到后端源站。这种架构在TCP上工作得很好，但每次新连接都需要完成TCP三次握手和TLS握手，对于移动端或高延迟网络来说，额外往返会拖慢首字节时间。HTTP/3基于QUIC协议，在UDP上复用了TLS 1.3握手，客户端可以在第一次连接时就发送应用数据，并且支持连接迁移和更精细的流控。Apache httpd通过mod_http3模块提供了实验性的HTTP/3基础QUIC支持，可以让你在保留mod_proxy和mod_cache配置的同时，增加UDP 443监听。下面会从编译、配置到验证逐步说明。
一、Apache代理缓存与HTTP/3的协同机制
在传统的HTTPS代理缓存场景中，客户端先与Apache建立TCP连接，然后进行TLS握手，握手完成后才发送HTTP请求。mod_proxy将请求转发给后端，mod_cache根据缓存策略检查是否可以命中缓存，命中则直接返回缓存内容，否则从源站拉取并缓存。这个过程依赖TCP的可靠传输，但TCP的队头阻塞和握手延迟在高丢包环境下会放大。
HTTP/3换用了QUIC传输协议，QUIC运行在UDP之上，自己实现了可靠传输、拥塞控制和加密。一个关键差异是QUIC在连接建立阶段同时完成了加密协商和应用数据传输，首包延迟远低于TCP加TLS。Apache的mod_http3模块负责处理UDP 443上的QUIC连接，解出HTTP/3请求后交给相同的代理缓存流水线。也就是说，缓存逻辑完全不用改动，只是入口传输层从TCP换成了UDP。
要让客户端知道服务器支持HTTP/3，通常有两种方式：一是通过HTTPS响应头Alt-Svc告知备用端口；二是依赖DNS HTTPS记录。mod_http3可以自动生成Alt-Svc头，也可以手动用Header指令添加。无论哪种方式，前提都是443/UDP端口必须可达。
二、编译支持HTTP/3的Apache依赖与模块
Apache httpd的HTTP/3支持依赖ngtcp2和nghttp3两个库，它们分别实现了QUIC传输层和HTTP/3帧层。编译顺序必须是先装这两个库，再编译Apache。大多数发行版尚未提供稳定的ngtcp2/nghttp3开发包，因此建议从源码安装到/usr/local目录。以下命令展示了在Debian/Ubuntu系统上的典型流程。
# 安装基础工具和依赖 apt-get update apt-get install -y build-essential libtool autoconf automake pkg-config libssl-dev libnghttp2-dev libpcre3-dev # 编译并安装 ngtcp2 git clone https://github.com/ngtcp2/ngtcp2.git cd ngtcp2 autoreconf -i ./configure --prefix=/usr/local make -j$(nproc) make install # 编译并安装 nghttp3 git clone https://github.com/ngtcp2/nghttp3.git cd nghttp3 autoreconf -i ./configure --prefix=/usr/local make -j$(nproc) make install # 下载并编译 Apache httpd（这里以2.4.62版本为例） wget https://downloads.apache.org/httpd/httpd-2.4.62.tar.gz tar -xzf httpd-2.4.62.tar.gz cd httpd-2.4.62 ./configure \ --enable-http3 \ --with-ngtcp2=/usr/local \ --with-nghttp3=/usr/local \ --enable-proxy \ --enable-proxy-http \ --enable-cache \ --enable-cache-disk \ --enable-ssl \ --enable-headers \ --enable-deflate \ --prefix=/usr/local/apache2 make -j$(nproc) make install
配置脚本中的--enable-http3会触发mod_http3的构建，--with-ngtcp2和--with-nghttp3指定库的安装前缀。如果./configure阶段提示找不到库，需要检查PKG_CONFIG_PATH是否包含/usr/local/lib/pkgconfig。编译完成后，用apachectl -M查看模块列表中是否出现http3_module。
三、配置反向代理缓存与HTTP/3监听
安装完成后，需要编辑主配置文件httpd.conf来加载必要模块、声明UDP监听以及设置代理缓存规则。下面给出一个最小可用的配置片段。注意Listen 443 http3与Listen 443 ssl可以并存，它们分别占用UDP和TCP的443端口，互不冲突。
Listen 80
Listen 443 ssl
Listen 443 http3
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
LoadModule ssl_module modules/mod_ssl.so
LoadModule headers_module modules/mod_headers.so
LoadModule http3_module modules/mod_http3.so
<IfModule mod_http3.c>
H3Protocol on
H3AltSvc on
</IfModule>
<VirtualHost *:443>
ServerName ipipp.com
DocumentRoot /var/www/html
SSLEngine on
SSLCertificateFile /etc/ssl/ipipp.com.crt
SSLCertificateKeyFile /etc/ssl/ipipp.com.key
SSLCertificateChainFile /etc/ssl/ipipp.com-chain.crt
ProxyPass / http://127.0.0.1:8080/
ProxyPassReverse / http://127.0.0.1:8080/
CacheEnable disk /
CacheRoot /var/cache/apache2/mod_cache_disk
CacheDefaultExpire 3600
CacheMaxExpire 86400
CacheIgnoreNoLastMod On
Header always set Alt-Svc 'h3=":443"; ma=86400'
</VirtualHost>
配置中ProxyPass把所有请求转发到本机8080端口的后端服务，CacheEnable disk开启磁盘缓存并指定根路径。需要确保/var/cache/apache2/mod_cache_disk目录存在且Apache进程有写权限。Alt-Svc头告诉浏览器后续请求可以直接使用HTTP/3访问，ma=86400表示该信息在24小时内有效。
如果希望仅缓存特定资源类型，可以使用CacheEnable disk /images配合CacheEnable disk /css等，避免缓存动态页面。同时建议开启CacheLock防止缓存击穿，以及设置合理的CacheMaxExpire控制缓存时间。
四、验证HTTP/3连接与常见问题排查
完成配置后，重启Apache并检查UDP 443端口是否正常监听。可以使用ss -ulnp | grep 443查看。然后使用curl命令测试HTTP/3连接：
# 使用curl强制走HTTP/3 curl --http3-only -I https://ipipp.com/ # 查看详细连接过程 curl --http3 -v https://ipipp.com/ 2>&1 | grep -E 'Using HTTP|Connected'
如果curl输出中包含Using HTTP/3，说明QUIC协商成功。也可以打开浏览器开发者工具，在Network面板查看Protocol列显示h3。需要注意的是，curl需要编译时启用HTTP/3支持，通常通过curl --version看到HTTP3特性即可。
常见问题包括：UDP 443端口被防火墙或云安全组拦截；TLS证书链不完整导致QUIC握手失败；mod_http3与mod_ssl的ALPN协商协议不匹配。如果客户端连接自动回退到TCP，先检查Alt-Svc头是否正常返回，再检查UDP端口连通性。另外，某些负载均衡器或中间设备会阻断UDP流量，需要提前确认网络策略。
Apache代理缓存HTTP/3QUIC修改时间：2026-09-25 10:20:45