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> 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 认证流程。

下载