Apache HTTP Server 从 2.4.53 版本开始引入了实验性的 HTTP/3 支持，通过 mod_http3 模块实现 QUIC 和 HTTP/3 协议。与传统的基于 TCP 的 HTTP/1.1 和 HTTP/2 不同，HTTP/3 运行在 UDP 之上，使用 QUIC 提供可靠传输、加密和连接迁移能力。如果希望 Apache 同时作为反向代理和缓存服务器，并让客户端通过 HTTP/3 访问，需要同时配置 mod_proxy、mod_cache 以及 mod_http3。在树莓派或类似设备上使用 bcm43438 无线网卡时，还需要考虑 UDP 在高干扰环境下的性能特征。
编译启用 Apache 的 HTTP/3 支持
要让 Apache 真正接受 HTTP/3 连接，仅靠发行版预编译包通常不够，因为 mod_http3 依赖的 nghttp3、ngtcp2 以及支持 QUIC 的 OpenSSL 分支并不总是默认可用。以 quictls 为例，需要先编译安装 quictls 到独立目录，再编译 ngtcp2 和 nghttp3。这样做的目的是确保 TLS 库能够处理 QUIC 握手中的短包头和连接迁移参数，同时避免与系统 OpenSSL 产生符号冲突。完成依赖准备后，重新编译 Apache 时需要显式添加 --enable-http3、--enable-proxy 和 --enable-cache 等选项，让这些模块被静态或动态编译进去。
安装完成后，可以在主配置文件中开启 mod_http3、mod_proxy 和 mod_cache，然后调整监听指令。传统 HTTP/1.1 和 HTTP/2 都基于 TCP，因此使用 Listen 443 即可；但 HTTP/3 需要单独的 UDP 监听，使用 Listen 443 quic 可以让 Apache 在同一个端口上区分协议栈。TLS 证书依然复用原有的 443 端口证书，但必须确保证书链完整并且支持 TLS 1.3，因为 HTTP/3 的握手依赖 TLS 1.3 中的 ALPN 扩展来协商 h3 协议。
# 安装依赖并编译支持 HTTP/3 的 Apache ./configure --prefix=/opt/apache-http3 --enable-http3 --enable-proxy --enable-cache --enable-cache-disk --with-ssl=/opt/quictls --with-nghttp3=/opt/nghttp3 --with-ngtcp2=/opt/ngtcp2 make -j$(nproc) make install
配置虚拟主机时，需要在 VirtualHost 中使用 Protocols 指令列出允许的协议。一个典型的 HTTPS 虚拟主机可以写成如下形式，同时服务 HTTP/3、HTTP/2 和 HTTP/1.1 客户端。这能兼容不支持 QUIC 的旧浏览器，同时为现代浏览器提供更快的握手和更稳的多路复用。
<VirtualHost *:443>
ServerName ipipp.com
Protocols h3 h2 http/1.1
SSLEngine on
SSLCertificateFile /etc/ssl/certs/server.crt
SSLCertificateKeyFile /etc/ssl/private/server.key
SSLCertificateChainFile /etc/ssl/certs/chain.crt
SSLProtocol -all +TLSv1.3
ErrorLog /var/log/apache2/quic_error.log
CustomLog /var/log/apache2/quic_access.log combined
</VirtualHost>
配置反向代理与磁盘缓存
启用 HTTP/3 之后，Apache 自身只负责接收客户端的 UDP 流量，而真正的业务请求仍然需要转发到后端服务。此时可以使用 mod_proxy 和 mod_proxy_http 将请求反向代理到本机或局域网内的 HTTP/1.1 服务。反向代理的价值在于隔离后端、统一入口，同时配合 mod_cache_disk 可以把可缓存的响应直接存储在磁盘中，减少后端压力并加速重复请求。配置缓存时，需要指定缓存根目录、缓存开关以及缓存有效期。
一个完整的反向代理缓存配置通常包含以下几个关键指令：ProxyPass 定义路径映射，ProxyPassReverse 修正后端返回的重定向头，CacheEnable disk 开启磁盘缓存，CacheRoot 指定存储位置，CacheDefaultExpire 和 CacheMaxExpire 控制缓存时间。需要特别注意的是，如果后端响应包含 Set-Cookie 头，Apache 默认不会缓存，因为可能涉及用户私有数据；可以通过 CacheIgnoreHeaders 强制忽略某些头部，但必须谨慎处理，避免缓存敏感信息。
<IfModule mod_cache.c>
CacheEnable disk /
CacheRoot /var/cache/apache2/proxy
CacheDefaultExpire 3600
CacheMaxExpire 86400
CacheLastModifiedFactor 0.5
CacheIgnoreHeaders Set-Cookie
</IfModule>
ProxyPass / http://127.0.0.1:8080/
ProxyPassReverse / http://127.0.0.1:8080/
CacheDisable /admin
缓存目录必须确保 Apache 运行用户拥有读写权限，否则请求会直接穿透到后端，同时在错误日志中记录权限拒绝信息。可以使用 chown www-data:www-data /var/cache/apache2/proxy 修正权限。对于动态内容较多的站点，建议用 CacheDisable 排除登录、购物车等路径，只缓存静态资源和可公开访问的 API 响应。
针对 bcm43438 无线网络的优化
bcm43438 是博通推出的一款低功耗 WiFi 芯片，常见于树莓派 3B、Zero W 等开发板，只支持 2.4GHz 频段和单空间流 802.11n，理论速率约为 72.2Mbps。这种芯片在真实环境中容易受到蓝牙、微波炉和其他 2.4GHz 设备的干扰，UDP 数据包在无线链路上也更容易出现乱序和丢失。QUIC 协议虽然具备前向纠错和快速重传，但如果底层 UDP 持续丢包，吞吐量会显著下降，甚至不如传统的 HTTP/2 over TCP。因此，针对 bcm43438 进行无线接口和内核参数调优十分必要。
第一步是关闭无线网卡的省电模式。树莓派默认可能启用 WiFi 省电，会导致延迟抖动和突发丢包。使用 iw dev wlan0 set power_save off 可以立即关闭省电，也可以用 iwconfig wlan0 power off 保持兼容。第二步是调整内核 UDP 缓冲区，避免在高吞吐时丢包。通过 sysctl 增大 net.core.rmem_max 和 net.core.wmem_max 到 16MB 或更高，可以给 QUIC 协议栈更多缓冲空间。第三步是检查 MTU，如果网络中存在 PPPoE 或 VPN 隧道，UDP 分片会增加失败概率，设置 ip link set dev wlan0 mtu 1472 可以避免部分分片问题。
# 关闭 WiFi 省电 iw dev wlan0 set power_save off # 调整 UDP 缓冲区 sysctl -w net.core.rmem_max=16777216 sysctl -w net.core.wmem_max=16777216 sysctl -w net.core.rmem_default=1048576 sysctl -w net.core.wmem_default=1048576 # 设置无线网卡 MTU ip link set dev wlan0 mtu 1472
Apache 层面也需要根据无线带宽限制做相应调整。bcm43438 的实际可用带宽可能只有 30-40Mbps，如果同时有大量 HTTP/3 连接，很容易把无线链路打满并引发连锁重传。可以适当限制 MaxRequestWorkers、减小 KeepAliveTimeout，并且为代理请求设置较短的 ProxyTimeout。这些参数不会提升单连接吞吐，但能避免连接堆积，让缓存命中后的响应更快返回。
验证 HTTP/3 与常见故障排查
完成配置后，需要确认 Apache 是否真正监听 UDP 443 端口。可以使用 ss -lunp | grep 443 查看 UDP 套接字，如果没有任何输出，说明 Listen 443 quic 没有生效，或者 mod_http3 加载失败。另外，使用支持 HTTP/3 的 curl 命令可以快速验证：curl --http3 -I https://ipipp.com/。如果返回正常的 HTTP 响应头，并且响应中包含 alt-svc 头提示 h3，就说明 QUIC 路径已经打通。
浏览器验证时，可以在开发者工具的 Network 面板中把 Protocol 列显示出来，观察请求是否标记为 h3。如果始终显示 http/1.1 或 h2，常见原因包括：防火墙或 NAT 没有放行 UDP 443；证书链不完整导致 ALPN 协商失败；Apache 编译时未链接正确的 nghttp3 库；或者客户端本身在无线网络环境下自动降级到 TCP。此时可以结合 Apache 的 ErrorLog 查看 QUIC 握手错误，例如证书验证失败、版本不匹配或无法创建 UDP 套接字。
# 检查 UDP 443 监听 ss -lunp | grep 443 # 使用 curl 测试 HTTP/3 curl --http3 -I https://ipipp.com/ # 查看 Apache 错误日志中的 QUIC 相关记录 tail -f /var/log/apache2/quic_error.log
对于 bcm43438 设备，如果验证过程中发现 HTTP/3 偶尔能连接但很快断开，可以尝试临时切换到有线网络测试，以排除无线链路本身的问题。若有线正常而无线异常，重点检查省电是否关闭、UDP 缓冲区是否足够以及周围信道干扰是否严重。通过调整信道或靠近路由器，往往能显著改善 QUIC 在低功耗 WiFi 芯片上的表现。经过这些排查和优化，一个在 bcm43438 无线环境下稳定运行的 Apache HTTP/3 反向缓存代理就可以正常服务了。
Apache代理缓存HTTP/3QUIC修改时间：2026-08-20 02:44:00