apache无法用addoutputfilter直接前后插入html，但可通过mod_substitute替换标签实现：启用filter和substitute模块，在text/html响应中用正则插入ssi包含指令，并配合mod_include解析执行。
Apache 本身不支持直接用 AddOutputFilter 在响应体“前后”动态插入 HTML 内容（比如全局 header/footer）。它没有内置的“前置/后置注入”过滤器。但你可以通过 mod_filter + mod_substitute + 输出链控制 实现等效效果，关键在于把插入逻辑写进响应体处理流程里，并确保只作用于 text/html 类型。
✅ 真正可行的方式：用 mod_substitute 替换
这是最稳定、无需外部程序、兼容 Apache 2.4+ 的做法。原理是：
在响应返回前，用正则匹配并替换 body 开始与结束标签，在其中插入你的公共内容。
1. 启用必要模块
确认以下模块已加载（取消 httpd.conf 中对应行的注释）：
LoadModule filter_module modules/mod_filter.so LoadModule substitute_module modules/mod_substitute.so
运行 httpd -M | grep -E "(filter|substitute)" 验证输出含 filter_module 和 substitute_module。
2. 在虚拟主机或 <directory></directory> 块中配置插入逻辑
<ifmodule mod_filter.c>
FilterDeclare insert_header_footer
FilterProvider insert_header_footer SUBSTITUTE "%{CONTENT_TYPE} =~ m|^text/html|"
FilterChain insert_header_footer
SetOutputFilter insert_header_footer
</ifmodule><ifmodule mod_substitute.c>
# 在 后插入 header.html 内容（需提前准备好该文件，且可被 Apache 读取）
Substitute "s||\n<!--#include virtual=\"/includes/header.shtml\" -->|i"
# 在 前插入 footer.html 内容
Substitute "s||<!--#include virtual=\"/includes/footer.shtml\" -->\n|i"
</ifmodule>
⚠️ 注意：
-
Substitute指令必须放在FilterProvider启用之后，且在同一作用域（如都写在<virtualhost></virtualhost>内）； -
<!--#include virtual="..." -->能生效的前提是：你已按 SSI 要求启用了mod_include，并在该目录设置了Options +Includes； - 被包含的
/includes/header.shtml文件需放在DocumentRoot下（如/var/www/html/includes/header.shtml），权限为644； -
s|...|...|i是 Perl 兼容正则语法，i表示忽略大小写，适配或。
3. 补充 SSI 支持（否则 include 不执行）
在同个 <virtualhost></virtualhost> 或 <directory></directory> 中加：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
<directory>
Options +Includes
AddType text/html .shtml
AddOutputFilter INCLUDES .shtml
Require all granted
</directory>
⚠️ 这里
Substitute处理的是.html响应，而<!--#include-->是 SSI 指令 —— Apache 会在Substitute插入后，再由INCLUDES过滤器解析执行，形成两阶段处理。
❌ 不推荐的方式：试图用 AddOutputFilter 直接“包裹”内容
AddOutputFilter 只能挂载已有过滤器（如 DEFLATE, INCLUDES, SUBSTITUTE），不能定义新行为。它不接受自定义脚本或模板参数，也无法像 Nginx 的 sub_filter 那样灵活配置多段插入。所谓“前后插入”，必须靠 Substitute 正则替换实现，不是靠 filter 名称拼接。
? 替代方案：用 mod_ext_filter 调外部脚本（仅限高级场景）
如果你需要更复杂的逻辑（比如根据 URL 动态生成 header、插入用户信息），可启用 mod_ext_filter：
ExtFilterDefine inject_html mode=output intype=text/html cmd="/usr/local/bin/inject-wrapper.sh"
<directory>
SetOutputFilter inject_html
</directory>
然后编写 inject-wrapper.sh，读取 stdin（原始 HTML）、插入内容、输出到 stdout。
但此方式增加进程开销、需严格管控脚本权限和超时，开发调试成本高，一般项目不建议。
不复杂但容易忽略：真正起作用的是 Substitute + INCLUDES 的组合，而不是某个神奇的 AddOutputFilter 指令。只要路径对、模块开、正则准、权限足，插入就能稳稳生效。
