Windows 官方Nginx二进制包默认不包含sub_filter模块，因其基于旧构建环境且该模块属非核心、需显式编译启用；社区侧重Linux生产部署，故未优先支持。
Windows 版 Nginx 官方二进制包默认不包含 sub_filter 模块（即 ngx_http_sub_module），该模块用于在响应体中进行字符串替换，比如修改 HTML 中的 URL、注入脚本或重写文本内容。它在 Linux 下通常随 --with-http_sub_module 编译选项启用，但 Windows 官方预编译版未开启此功能。
为什么 Windows 官方 Nginx 没有 sub_filter？
官方 Windows 版本基于较旧的构建环境，长期未同步新增模块支持；且 sub_filter 属于非核心模块，需显式启用编译。社区普遍认为 Windows 更多用于开发/测试，生产环境推荐 Linux，因此模块完整性非优先项。
可用的替代方案
- 使用第三方编译版 Nginx：如 nginx-win 或 substitutions4nginx（增强版 sub_filter，支持正则和多模式）——部分已预编译支持 Windows。
-
改用 OpenResty for Windows：集成了 Lua 支持，可通过
content_by_lua_block+string.gsub实现更灵活的内容替换，适合复杂逻辑。 - 前端代理层处理：在 Nginx 前加一层轻量服务（如 Node.js 的 http-proxy-middleware、Python 的 Flask + requests），拦截响应并替换内容，Nginx 仅负责转发。
若坚持用原生 Nginx，可尝试的变通方法
虽不能动态替换响应体，但可通过以下方式间接达成部分目标：
- 利用
add_header注入自定义 HTTP 头，供前端 JS 读取并操作 DOM； - 用
return 200+ 内联 HTML 配合变量（如$arg_xxx）生成简单定制页面； - 将需替换的内容抽离为独立 JS/CSS 文件，用 Nginx 的
location和alias指向不同版本，实现“静态切换”。
验证是否启用 sub_filter 的方法
在配置中添加如下测试段落，重启后访问对应 location：
location /test-sub {
proxy_pass http://example.com/;
sub_filter '<head>' '<head><script>console.log("replaced");</script>';
sub_filter_once on;
}
若返回 501 Not Implemented 或日志报 unknown directive "sub_filter"，说明模块未加载。
