ngx_http_sub_module 模块是一个过滤器,它通过将一个指定的字符串替换为另一个来修改响应。
默认情况下不构建此模块,应使用 --with-http_sub_module 配置参数启用它。
location / { sub_filter '<a href="http://127.0.0.1:8080/' '<a href="https://$host/'; sub_filter '<img src="http://127.0.0.1:8080/' '<img src="https://$host/'; sub_filter_once on; }
语 法:sub_filter string replacement; 默认值:— 上下文:http, server, location
设置要替换的字符串和替换字符串。要替换的字符串匹配忽略大小写。要替换的字符串 (1.9.4) 和替换字符串可以包含变量。可以在同一配置级别 (1.9.4) 上指定多个 sub_filter 指令。当且仅当当前级别上没有定义 sub_filter 指令时,这些指令才从先前的配置级别继承。
语 法:sub_filter_last_modified on | off; 默认值:sub_filter_last_modified off; 上下文:http, server, location
该指令出现在 1.5.1 版中。
允许在替换期间保留原始响应中的“Last-Modified”标头字段,以促进响应缓存。
默认情况下,当响应的内容在处理过程中被修改时,头字段会被删除。
语 法:sub_filter_once on | off; 默认值:sub_filter_once on; 上下文:http, server, location
指示是查找要替换的每个字符串一次还是重复。
语 法:sub_filter_types mime-type ...; 默认值:sub_filter_types text/html; 上下文:http, server, location
除了 “text/html” 之外,还使用指定的 MIME 类型在响应中启用字符串替换。特殊值 “*” 匹配任何 MIME 类型 (0.8.29)。