在嵌入式开发场景中，pcduino这类小性能开发板常被用来运行轻量Web服务，例如传感器数据展示页、设备管理面板等。问题在于，开发板的CPU与内存资源非常有限，一旦页面需要反代上游服务，网络往返与握手开销会明显拖慢响应速度。Apache从2.4.52版本开始逐步引入HTTP/3（QUIC）支持，配合自带的mod_cache代理缓存模块，可以在弱网和高延迟环境下大幅改善体验。本文将代理缓存与QUIC结合起来，给出一套适合小型设备的完整配置思路。
一、代理缓存与QUIC的工作原理
先说代理缓存。Apache的mod_cache模块工作在反向代理模式下时，会把上游服务器返回的可缓存响应（通常依据Cache-Control、Expires等响应头判断）保存到本地磁盘或共享内存中。后续客户端请求命中缓存时，Apache直接从本地返回内容，无需再向上游发起TCP连接，这对上游算力弱、网络链路长的场景收益极大。相关的模块包括负责核心缓存逻辑的mod_cache、磁盘存储后端mod_cache_disk，以及反向代理引擎mod_proxy。
再看QUIC。HTTP/3放弃了传统的TCP传输层，改用基于UDP的QUIC协议。它的核心优势有三点：一是0-RTT握手，客户端在第二次连接时可以携带业务数据直接完成请求；二是连接迁移，设备切换网络（例如从Wi-Fi切到蜂窝）时连接标识符不变，会话不中断；三是彻底解决TCP层的队头阻塞问题，多个流之间互不影响。这三点恰好对pcduino这类常部署在无线网络环境下的小设备十分友好。
把两者结合的思路是：pcduino背后的真实服务保持不变，前面架设一台Apache节点（可以就在开发板本地，也可以是单独的网关机器），Apache负责QUIC接入和缓存回源。客户端到Apache这一段走HTTP/3快速传输，Apache到上游这一段走普通HTTP/1.1或HTTP/2回源，并尽量命中本地缓存。
二、编译与启用HTTP/3支持
目前主流发行版的Apache默认未启用QUIC模块，需要确认httpd版本并加载mod_http3。以编译安装为例，依赖项包括libngtcp2、nghttp3等QUIC库。编译Apache时可执行类似如下配置：
# 安装QUIC相关依赖（以Debian系为例） apt install build-essential libssl-dev libngtcp2-dev libnghttp3-dev # 编译Apache并启用所需模块 ./configure --enable-http3 --enable-cache \ --enable-cache-disk --enable-proxy --enable-proxy-http \ --with-ssl --enable-ssl make && make install
编译完成后，在httpd.conf中加载模块并开启协议监听：
LoadModule http3_module modules/mod_http3.so LoadModule cache_module modules/mod_cache.so LoadModule cache_disk_module modules/mod_cache_disk.so LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so Protocols h3 h2 http/1.1 Listen 443
注意QUIC基于UDP，端口监听走的是443/udp，务必在防火墙或路由器上放行UDP 443，否则客户端会静默回退到HTTP/2，你甚至察觉不到QUIC没有生效。验证方法可以在浏览器开发者工具的协议列查看是否显示h3，或者用命令行确认UDP端口是否处于监听状态。
证书方面，QUIC强制要求TLS 1.3，因此需要确保证书配置正确且加密套件足够新。自签证书在局域网测试可行，但要开启0-RTT等特性，建议使用正式签发的证书。
三、反向代理与缓存的完整配置
接下来把代理与缓存串起来。典型配置如下，假设pcduino上的真实服务跑在8080端口：
CacheRoot /var/cache/httpd/proxy
CacheDirLevels 2
CacheDirLength 1
CacheMaxFileSize 10000000
CacheIgnoreNoLastMod On
<VirtualHost *:443>
ServerName gw.local
Protocols h3 h2 http/1.1
SSLEngine on
SSLCertificateFile /etc/ssl/certs/gw.crt
SSLCertificateKeyFile /etc/ssl/private/gw.key
ProxyRequests Off
ProxyPass / http://127.0.0.1:8080/
ProxyPassReverse / http://127.0.0.1:8080/
CacheEnable disk /
CacheHeader On
CacheDefaultExpire 300
</VirtualHost>
配置中有几个参数值得展开。CacheDirLevels和CacheDirLength决定磁盘缓存的目录层级，小设备上单层目录即可，避免过深的路径查找开销。CacheDefaultExpire设置了没有明确过期头内容兜底的有效期，传感器数据这类频繁变化的内容建议设置在60到300秒之间，静态资源则可以放得更长。
缓存命中判断还取决于上游响应头。如果上游服务返回了Cache-Control: no-store，Apache会尊重该指令不缓存。因此需要检查pcduino上应用框架的默认响应头，必要时在上游显式设置Cache-Control: public, max-age=60。另外可以用CacheHeader On让Apache在响应中附加X-Cache状态头，调试时通过它区分HIT与MISS非常直观。
对动态内容要有选择地缓存。例如API接口中只对GET请求启用缓存，POST等写操作必须绕过，可以通过CacheEnable disk /static只对特定路径开启，而不是全站一刀切。
四、面向pcduino低功耗设备的调优建议
在开发板上跑Apache，首先要控制进程数。默认的mpm_event配置对桌面服务器合适，但对512MB内存级别的设备偏重，建议将ServerLimit与MaxRequestWorkers压到20以内，ThreadsPerChild设为8到16，留出足够内存给缓存IO和上层应用。
其次考虑缓存介质。开发板的SD卡随机写性能较差，频繁的缓存写入会拖垮整体吞吐。如果板载eMMC或外接了USB存储，把CacheRoot指过去；数据量小的情况下也可以评估共享内存方案。同时用CacheMaxFileSize限制单文件大小，避免大文件刷爆磁盘。
QUIC本身也有额外开销：UDP收发缓冲区、加解密运算都会占用CPU。在百兆级别的ARM芯片上，如果发现负载偏高，可以在Protocols中把h3的优先级调低，让客户端优先协商h2，作为性能与体验之间的折中。此外建议开启htcacheadm或定期任务清理过期缓存，防止磁盘占满导致写入失败。
最后是排查思路。QUIC不生效优先查UDP 443放行与证书链；缓存不命中先看X-Cache头与上游Cache-Control；回源异常则检查ProxyPass路径映射和日志中的proxy相关错误记录。掌握这三条主线，绝大多数问题都能快速定位。
Apache代理缓存HTTP/3QUIC修改时间：2026-09-01 03:42:52