apache 2.4.49+需启用mod_proxy_hcheck并用proxyhcexpr配合%{hc resp body}匹配响应体关键字（如"status":"up"），通过hcexpr=绑定到balancermember的hcuri路径实现内容级健康探测。

要在 Apache 中用 mod_proxy_hcheck 实现基于内容关键字的健康探测，关键不是只看 HTTP 状态码，而是解析响应体（body）并匹配指定字符串——比如后端返回 {"status":"ok"} 或 alive:true 这类文本。这必须配合 ProxyHCExpr 指令，且对 Apache 版本有明确要求。

确认版本与模块可用性

该功能依赖两个前提：

• Apache ≥ 2.4.49：只有这个版本起才支持 %{hc resp body} 变量，用于提取健康检查响应的原始 body 内容；旧版本（如 2.4.41、2.4.46）只能用 %{REQUEST_STATUS} 或响应头字段，无法读取 body。
• mod_proxy_hcheck 已加载：运行 httpd -M | grep hcheck，有输出才表示模块就绪；若无，需在配置中显式添加：
  LoadModule proxy_hcheck_module modules/mod_proxy_hcheck.so

定义内容匹配表达式

使用 ProxyHCExpr 创建自定义判断逻辑，语法为正则匹配。例如：

• 匹配 JSON 响应中的 "status": "up"（忽略空格）：
  ProxyHCExpr isup {%{hc resp body} =~ /"status"\s*:\s*"up"/}
• 匹配纯文本含 OK 且不区分大小写：
  ProxyHCExpr okcase {%{hc resp body} =~ (?i)OK}
• 匹配 health 字段值为 true：
  ProxyHCExpr healthy {%{hc resp body} =~ /"health"\s*:\s*true/}

注意：表达式名（如 isup）后续要在 BalancerMember 中通过 hcexpr= 引用。

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

绑定到后端节点并指定检查路径

在 <proxy balancer:></proxy> 块中为每个后端配置探测参数：

• hcuri=/healthz：指向后端真实暴露的健康接口（如 Spring Boot 的 /actuator/health），不能是 Apache 自身路径
• hcmethod=GET 或 HEAD：推荐 GET，因 HEAD 不带 body，无法用于内容匹配
• hcexpr=isup：引用上一步定义的表达式名
• hcinterval=5：每 5 秒发起一次请求（太短易压垮后端，太长恢复滞后）

完整示例：

ProxyHCExpr isup {%{hc resp body} =~ /"status"\s*:\s*"up"/}

  BalancerMember http://10.0.1.10:8080 hcexpr=isup hcinterval=5 hcuri=/healthz hcmethod=GET

ProxyPass "/api" "balancer://app/api"
ProxyPassReverse "/api" "balancer://app/api"

验证与调试要点

仅靠 balancer-manager 页面状态不够，要确认内容匹配是否生效：

• 开启详细日志：LogLevel proxy_hcheck:trace8，在 error_log 中搜索 hcheck，查看是否发出请求、收到什么 body、正则是否命中
• 手动测试后端接口：curl -s http://10.0.1.10:8080/healthz，确保返回内容格式稳定、不含不可见字符（如 BOM）
• 避免误判：若后端健康接口返回 200 但 body 是 {"alive":false}，而表达式未覆盖该逻辑，节点仍会被视为健康