mod_ext_filter必须按FilterDeclare→FilterProvider→SetOutputFilter三步链式配置，缺一或错序即静默失败；需启用模块、禁用sendfile/mmap、外部程序须严格处理二进制流并设timeout。
mod_ext_filter 能调用外部程序做实时响应过滤，但默认不生效、极易静默失败，必须按三步链式配置且绕过 Apache 的 sendfile/mmap 优化才能真正触发。
模块没加载是“写了配置却没反应”的最常见原因
Apache 默认不启用 mod_ext_filter，哪怕你写全了所有指令，httpd -M | grep ext_filter 没输出就说明它根本没进内存。
- Debian/Ubuntu：运行
a2enmod ext_filter，再systemctl reload apache2 - RHEL/CentOS：取消
/etc/httpd/conf.modules.d/00-base.conf中#LoadModule ext_filter_module modules/mod_ext_filter.so的注释 - 源码编译安装：确认 configure 时加了
--enable-ext-filter，且配置文件里LoadModule行未被注释
漏掉这步，后续所有配置都是空转。
FilterDeclare + FilterProvider + SetOutputFilter 必须严格按序声明
这不是简单绑定命令，而是 Apache 内部的三段式注册机制：先起名、再定义执行逻辑、最后挂载到输出流。顺序错或缺一环，就会静默忽略或启动报错。
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
-
FilterDeclare myfilter只是注册一个符号名，不带任何行为 -
FilterProvider myfilter resp=Content-Type $text/html才真正指定“什么响应头触发”，注意大小写敏感、$是正则锚点，匹配值必须和实际响应头完全一致（比如text/html; charset=utf-8就不匹配$text/html） -
FilterChain myfilter必须出现在SetOutputFilter myfilter之前，否则 Apache 启动时报Invalid command 'SetOutputFilter' - 若用在
.htaccess，需确保AllowOverride包含Filter
静态文件（如图片、JS、CSS）默认绕过 filter，必须关掉 sendfile 和 mmap
Apache 对 image/jpeg、application/javascript 等类型默认启用内核级 sendfile 和 mmap，直接由 OS 发送文件，根本不走用户态 filter 流程——所以你看到状态码 200，但水印/替换/注入全没发生。
- 必须在 VirtualHost 或全局配置中显式加上：
EnableSendfile Off和EnableMMAP Off - 仅靠
AddType image/jpeg .jpg不够，还要确认响应头确实是Content-Type: image/jpeg（有些配置会误设成image/jpg） - 验证是否生效：用
curl -I https://yoursite/image.jpg看响应头有没有你脚本里加的调试标识（比如X-Filter-Applied: yes）
外部程序必须严格处理二进制流，超时和 stderr 日志是唯一定位手段
Apache 把响应体整块通过管道喂给你的程序 stdin，期望它原样或修改后从 stdout 吐出字节流。任意偏差都会导致连接卡死、返回空内容，甚至拖垮 worker 进程。
- 脚本必须读完全部 stdin（用
sys.stdin.buffer.read()，不是sys.stdin.read()），且 EOF 后立即退出 —— 不能等超时，也不能忽略关闭信号 - 务必加
timeout=5参数：例如ExtFilterDefine myfilter mode=output cmd="/path/to/script.py" timeout=5，防止单次 hang 住整个请求线程 - 加
ExtFilterOptions logStderr，把脚本 stderr 输出打到 Apache 错误日志，这是唯一能看清崩溃原因的途径 - 测试脚本独立运行：
cat test.html | ./filter.py > out.html，比对输入输出字节长度是否一致，不一致就说明有编码、BOM、缓冲或异常中断问题
真正难的从来不是写个能跑的脚本，而是让脚本在 Apache 的管道模型下稳定吞吐、不残留、不阻塞、不超时——这些边界条件一旦漏掉一个，线上就表现为偶发空白页或请求堆积。
