sub_filter

说明

sub_filter 指令允许你在由 NGINX 提供的 HTTP 流量的响应体中动态替换字符串。这对于即时修改内容特别有用，例如根据环境调整链接或文本，或用于本地化。该指令接受两个参数：第一个是要在响应体中查找的字符串，第二个是要替换成的字符串。每当 NGINX 处理响应时，它会在输出中扫描指定的搜索字符串出现位置，并在将响应发送给客户端之前用指定的替换字符串替换它们。 需要注意的是，sub_filter 指令仅在响应体大小小于配置的缓冲区大小且响应状态码在 200-299 范围内时才会生效。此外，如果正确配置了 'sub_filter_types' 指令，sub_filter 支持使用正则表达式来匹配字符串。这有助于实现更复杂的替换，但在使用正则表达式时需要小心，确保模式正确转义并精心编写，以避免意外匹配或由于复杂模式中过度回溯而导致的性能下降。

配置示例

location /example {
    sub_filter "example.com" "example.org";
    sub_filter_once off;
}