Apache ProxyPass 不主动中断下载，但默认配置易致隐式截断或卡在99%；需关闭ProxyBuffering、启用streaming、调大ProxyTimeout、优化keepalive及精简响应头。
apache 中 proxypass 本身不主动中断文件下载，但实际使用中常出现“下载到一半卡住”“进度停在 99%”“浏览器提示网络错误”等现象。根本原因不是 proxypass 指令写错了，而是默认配置与大文件、长连接、流式响应不匹配——缓冲、超时、连接复用、响应头这几项没调好，就会导致隐式截断或提前断连。
关闭代理缓冲，启用流式透传
大文件下载本质是持续字节流，Apache 默认会把整个响应缓存后再发给客户端，内存或磁盘缓冲满就出问题。必须禁用：
-
ProxyBuffering Off—— 关键指令，彻底关闭响应体缓存 -
SetEnv proxy-sendbuffersize 0—— 强制零缓冲大小 -
EnableSendfile Off—— 避免内核 sendfile 与代理逻辑冲突（尤其在传输 GB 级文件时） - 若 Apache ≥ 2.4.37，建议加
ProxySet streaming=on，显式启用流式代理模式
延长并分层设置超时参数
下载耗时取决于文件大小和带宽，不能依赖默认 60 秒。需协同控制三类超时：
-
ProxyTimeout 600—— 全局代理总等待时间（单位秒），设为后端生成+传输完整文件的预期上限 -
<Proxy "http://backend"> ProxySet timeout=600 connectiontimeout=5 </Proxy>—— 对单后端精细化控制，connectiontimeout 要明显小于 timeout -
Timeout 600—— 同步调整全局请求超时，防止底层 socket 被 Apache 主动关闭
确保连接复用稳定，避免中间断链
频繁建连不仅慢，还容易因网络抖动或防火墙 idle 超时被切断：
-
ProxyPass /download/ http://10.0.1.10:8080/download/ keepalive=on—— 显式开启后端连接复用 -
ProxySet keepalive_timeout=10 max=30 acquire=3000—— 控制空闲连接生命周期和池容量，keepalive_timeout 建议 ≤ 后端的 connectionTimeout -
KeepAlive On+KeepAliveTimeout 5—— 前端客户端到 Apache 的连接也保持长连，减少握手开销 -
ProxyPreserveHost On—— 确保 Host 头透传，避免后端因虚拟主机识别失败而返回异常响应
精简响应头，防头部膨胀触发协议失败
某些后端（如 PHP 应用、CMS 或自定义 API）会在响应头中注入大量调试信息、缓存标签或重复 Cookie，单个响应头超过 Apache 默认 8KB 限制时，会导致静默截断或 500 错误：
- 用
mod_headers移除非必要头：Header unset X-Debug-Info、Header unset X-Cache-Tags - 强制重写关键头：
Header set Cache-Control "no-cache, no-store, must-revalidate" - 若后端返回
Transfer-Encoding: chunked，确保不额外添加Content-Length，二者互斥
不复杂但容易忽略
aperture: the L402 aware reverse proxy
下载
安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
