如何利用 sub_filter 指令在负载均衡层动态注入生产环境专用的前端调试脚本-Nginx-PHP中文网

可在Nginx负载均衡层用sub_filter动态注入前端调试脚本，但仅适用于未压缩、Content-Type为text/html的响应，需预留锚点、配置sub_filter_once off和严格访问控制，并优先采用header注入+前端主动加载等更安全替代方案。

如何利用 sub_filter 指令在负载均衡层动态注入生产环境专用的前端调试脚本

可以在 Nginx 负载均衡层用 sub_filter 动态注入前端调试脚本，但需注意适用边界和安全风险——它只适用于 HTML 响应体中可预测位置的文本替换，且仅在启用 sub_filter 模块（通常默认编译进）并配合 sub_filter_once off 等配置时生效。

确保响应满足 sub_filter 的基本前提

sub_filter 不会修改任意响应，它只作用于 Nginx 作为代理返回的、Content-Type 为 text/html（或显式匹配的 MIME 类型）、且未被压缩（如 gzip）的响应体。因此需确认：

后端返回的 HTML 响应头中 Content-Type 明确为 text/html，不含 charset 冲突或非法字符
Nginx 未开启 gzip on 或已配置 gzip_vary off 并确保该路径不被压缩（或用 gzip_disable "msie6"; 等临时规避）
响应不是流式传输（如 chunked 编码需完整缓冲），需设置 proxy_buffering on 和足够缓存（如 proxy_buffer_size 128k）

精准定位插入点并编写安全替换规则

不要尝试在开头或结尾暴力追加，容易破坏结构或被 CSP 拦截。推荐在 HTML 中预留一个语义化锚点，例如后端模板中写：，然后在 Nginx 配置中：

location / {
    proxy_pass https://backend;
    sub_filter '<!-- DEBUG_INJECT -->' '<script src="/debug/prod-inspector.js" async></script>';
    sub_filter_once off;
    sub_filter_types text/html;
    sub_filter_last_modified off;
}

关键点：

HISUI 前端框架开发指南（IRIS版）

HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。

下载

sub_filter_once off 允许多次匹配（避免只替换第一个锚点）
sub_filter_types 必须显式包含 text/html，否则默认不处理
调试脚本建议托管在独立静态路径（如 /debug/），由 Nginx 直接服务，并配置严格限访问（如 allow 10.0.0.0/8; + deny all;）