在线文档教程
Nginx

ngx_http_sub_module

Module ngx_http_sub_module

  • 示例配置

  • 指令

  • sub_filter

  • sub_filter_last_modified

  • sub_filter_once

  • sub_filter_types

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字符串替换;
默认:
语境:http,服务器,位置

设置要替换的字符串和替换字符串。要替换的字符串匹配忽略大小写。要替换的字符串(1.9.4)和替换字符串可以包含变量。sub_filter可以在一个配置级别(1.9.4)中指定几个指令。当且仅当没有sub_filter在当前级别上定义的指令时,这些指令才从前一级继承。

句法:在|上的sub_filter_last_modified 关闭;
默认:sub_filter_last_modified关闭;
语境:http,服务器,位置

允许在替换期间保留来自原始响应的“Last-Modified”标题字段以促进响应缓存。

默认情况下,在处理期间修改响应的内容时,标题字段被删除。

句法:sub_filter_once在|上 关闭;
默认:sub_filter_once on;
语境:http,服务器,位置

指示是否查找每个字符串以替换一次或重复。

句法:sub_filter_types mime-type ...;
默认:sub_filter_types text / html;
语境:http,服务器,位置

除了“ text/html” 之外,还可以在指定MIME类型的响应中启用字符串替换。特殊值“ *”匹配任何MIME类型(0.8.29)。