Nginx sub_filter可在反向代理层动态隐藏HTML模块而不改前端代码；需精准匹配带唯一标识的静态HTML片段，用注释或display:none安全替换，配置sub_filter_types、gunzip on及sub_filter_last_modified off，并灰度验证。

利用 Nginx 的 sub_filter 指令，可以在反向代理层直接修改响应体内容，实现不改前端代码、不重启服务的前提下动态隐藏或下线网页中的特定功能模块（如按钮、区块、脚本等）。关键在于精准定位 HTML 片段并安全替换，同时规避常见陷阱。

精准匹配目标模块的 HTML 片段

sub_filter 本质是字符串替换，必须确保被替换的内容在响应中完整、唯一、稳定。推荐做法：

• 为待下线模块添加专属标识，例如：<div id="pay-button-v2" class="feature-module">...</div>
• 避免匹配过于宽泛的内容（如仅用 "支付"），防止误伤其他文本
• 确认该 HTML 片段未被 JavaScript 动态生成（sub_filter 只处理服务端返回的原始 HTML）
• 开启 sub_filter_once off 可多次匹配同一页面中的多个同类模块

安全替换：用注释或空标签替代而非删除

直接删除 HTML 标签易导致结构错乱（如闭合标签缺失、CSS/JS 依赖异常）。更稳妥的方式是「软下线」：

• 替换成 HTML 注释：sub_filter '<div id="promo-banner">' '<!-- [OFFLINE] promo-banner removed -->';<li>或替换为空的占位容器：<code>sub_filter '<section class="ai-chat">' '<section class="ai-chat disabled" style="display:none;">';</section></section>
• 若需移除内联脚本，可替换 <script>...</script> 为注释，但注意 JS 字符串中的 可能提前截断，建议配合 sub_filter_last_modified off 和严格边界控制

启用 sub_filter 的必要配置项

sub_filter 默认不生效，需显式启用并满足条件：

• 必须开启 sub_filter_types，支持 text/html 以外类型（如 application/json 不支持，但 text/plain 或自定义 MIME 可配）
• 确保响应头含 Content-Type: text/html，且未被压缩（gzip on 会干扰替换，需在 sub_filter 前加 gzip off 或使用 gunzip on 解压）
• 若后端启用了 ETag 或 Last-Modified 缓存，需加 sub_filter_last_modified off 避免缓存导致替换失效
• 配置示例：

  location / {
      proxy_pass https://backend;
      gunzip on;
      sub_filter '<div id="trial-cta">' '<div id="trial-cta" style="display:none;">';
      sub_filter_types text/html text/plain;
      sub_filter_once off;
      sub_filter_last_modified off;
  }

验证与灰度：先测再推，避免全站故障

上线前务必验证效果和副作用：

• 用 curl -H "Accept-Encoding: identity" http://your-domain/ 绕过 gzip 查看原始响应是否被正确替换
• 检查浏览器开发者工具的 Network → Response，确认 HTML 已变更且无语法错误
• 针对特定用户或 IP 灰度启用：用 map + if 控制是否加载 sub_filter 规则
• 监控 502/504 及页面白屏率——替换破坏 DOM 结构可能引发 JS 报错，建议搭配前端降级逻辑（如模块不存在时静默跳过初始化）