sub_filter可动态下线网页功能入口，本质是在HTML渲染前精准抹除DOM结构：需选唯一稳定锚点（如自定义注释），用空字符串替换，并配置sub_filter_once off、禁用gzip、扩展sub_filter_types以确保生效。

用 sub_filter 动态下线网页功能入口，本质是“在 HTML 渲染前，精准抹掉某段 DOM 结构”，无需改代码、不重启服务、不重载应用，适合紧急灰度、合规下架或临时屏蔽场景。

找准可替换的稳定锚点

sub_filter 不解析 HTML，只做字面匹配，所以必须选一个在页面中唯一、稳定、不易被压缩或格式化破坏的字符串作为“锚”。常见可靠锚点包括：

• 功能入口对应的完整 HTML 标签（如 系统设置）
• 包裹该入口的容器 ID 或 class（如
  或

  ）
• 自定义占位注释（推荐）：在前端源码中提前插入类似 的标记，专供 Nginx 替换使用

避免用易变内容（如按钮文案“查看日志”可能被多语言切换），也避免跨行结构（如 会被截断导致匹配失败）。

配置替换逻辑：隐藏 + 防残留

不是简单删掉标签，而是用空字符串或安全占位符替换，同时预防因替换导致的 HTML 结构错乱。典型写法：

• 直接移除整个功能区块（推荐）：
  sub_filter '' '';
• 注释掉入口链接（保留结构，便于快速恢复）：
  sub_filter '审计日志' '';
• 替换为禁用状态（视觉弱化）：
  sub_filter '调试工具' '调试工具';

务必配 sub_filter_once off，否则只处理第一个匹配项；若入口在 JS 或 CSS 中也有引用，需同步扩展 sub_filter_types（如 application/javascript text/css）。

确保响应可被 sub_filter 处理

以下三点任一缺失都会导致替换静默失效：

• 关闭响应压缩：在 location 块中加 proxy_set_header Accept-Encoding "";，并确认后端未强制返回 gzip/brotli 内容
• 显式声明 MIME 类型：默认只处理 text/html，若功能入口由 JS 注入，需加 sub_filter_types text/html application/javascript;
• 启用输出缓冲：Nginx 默认开启，但若后端使用流式 chunked 输出且未设 Content-Length，末尾内容可能丢失——建议后端返回完整响应体，或通过 proxy_buffering on; 强制缓冲

验证与回滚机制

上线前务必实测，重点检查：

• 用 curl -H 'Accept-Encoding:' 模拟无压缩请求，对比原始响应与 Nginx 返回差异
• 打开浏览器开发者工具，查看 Network → Response，确认 HTML 已被修改且无语法错误（如标签未闭合）
• 准备快速回滚方案：把替换指令注释掉，执行 nginx -s reload 即可即时恢复，全程秒级

不需要动应用，也不依赖发布流程，只要 Nginx 配置生效，下线动作就完成。