subs_filter无法实现真正全局替换，因其必须置于location块中且非nginx原生模块；需手动安装、显式加载，并在各location中分别配置替换规则。
直接在 Nginx 中配置 subs_filter 实现“全局文本替换”不可行，因为 subs_filter 是第三方模块（ngx_http_subs_filter_module），原生 Nginx 不包含它，且它本身也不支持真正意义上的全局作用域——它必须写在 location 块中，不能置于 http 块顶层。
确认是否已安装 subs_filter 模块
subs_filter 不是 Nginx 官方模块。主流发行版默认不提供：
- CentOS/RHEL 9：需手动安装
nginx-mod-http-sub并显式加载； - Debian/Ubuntu：部分仓库预编译包已集成，可通过
nginx -V 2>&1 | grep -o subs_filter验证； - 若未安装，需重新编译 Nginx 并添加
--add-module=../ngx_http_subs_filter_module。
安装后，在 nginx.conf 的 http 块顶部加载：
配置 subs_filter 替换规则（必须在 location 中）
该模块支持多组替换、正则匹配（区别于原生 sub_filter），但依然受限于作用域和响应类型：
- 每条
subs_filter指令独立执行，按书写顺序生效； - 支持大小写忽略：
subs_filter_ignore_case on;； - 支持 PCRE 正则：
subs_filter 'href="(https?://)old\.example\.com' 'href="$1new.example.com' r;； - 可同时处理响应头与响应体：
subs_filter_types *或显式指定如text/html application/json。
示例（CDN 域名批量替换）：
location / {proxy_pass https://origin;
subs_filter 'http://cdn\.old\.com' 'https://cdn.new.com' r;
subs_filter 'src="/assets/' 'src="/cdn/assets/' g;
subs_filter_types text/html text/css application/javascript;
proxy_set_header Accept-Encoding "";
}
模拟“全局”效果的实用做法
所谓“全局”，实为覆盖多数文本类响应路径，需避免误伤二进制内容（如图片、字体）：
- 用通配
location /统一配置，再用更具体的location ~ \.(png|jpg|woff2)$显式关闭替换； - 抽离规则到独立文件（如
/etc/nginx/conf.d/subs_rules.conf），通过include在多个location中复用； - 严格限定
subs_filter_types，不盲目设为*，防止 JSON 接口被意外修改结构； - 禁用上游压缩：
proxy_set_header Accept-Encoding ""，确保拿到明文响应体。
关键注意事项
subs_filter 虽比原生 sub_filter 更强，但仍受底层机制约束：
- 不解析 HTML DOM，无法智能识别属性上下文，替换
href值时仍可能破坏嵌套结构； - 正则匹配在流式响应中可能跨 chunk 失效，大响应建议启用
proxy_buffering on并调大缓冲区； - 不支持变量插值（如
$host），动态值需靠map预定义后引用； - 调试时可用
curl -sI查看Content-Encoding和Content-Type，确认是否满足处理前提。
