日期: 2016 年 5 月 27 日

该模块默认不会构建，需要通过–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

语法：sub_filter string replacement
默认：—
上下文：http, server, location

设置替换和被替换的字符串。字符串替换忽略大小写。要替换的字符串（1.9.4+）和替换字符串可以包含变量。多个sub_filter指令可以在同一个配置等级中指定（1.9.4+）。

sub_filter_last_modified

语法：sub_filter_last_modified on | off
默认：sub_filter_last_modified off
上下文：http, server, location
版本：1.5.1+

在替换过程中允许保留原始响应中的“Last-Modified”头域，以助于响应缓存。
默认情况下，头域会被删除因为在处理过程中响应发生了变化。

sub_filter_once

语法：sub_filter_once on | off
默认：sub_filter_once on
上下文：http, server, location

指示仅替换字符串一次，还是重复替换每一个字符串。

sub_filter_types

语法：sub_filter_types mime-type …
默认：sub_filter_types text/html
上下文：http, server, location

启用除“text/html”外指定的MIME类型处理响应替换。特殊值“*”匹配任何MIME请求（0.8.29+）。

该模块默认不会构建，需要通过–with-http_stub_status_module配置参数启用。

示例配置

location /basic_status {
    stub_status;
}

该配置创建了一个含有基本状态数据的简单网页，看起来如下：

Active connections: 291 
server accepts handled requests
 16630948 16630948 31070465 
Reading: 6 Writing: 179 Waiting: 106 

stub_status

语法：stub_status
默认：—
上下文：server, location

在location中可以访问基本状态信息。
在1.7.5版本之前，指令语法需要专门的参数，例如“stub_status on”。

数据
提供下面的状态信息：

Active connections
当前活动的客户端连接数包括等待的连接。

accepts
接收的客户端连接总数。

handled
处理连接总数。一般地，参数的值与accepts相同，除非一些资源的限制达到了（比如worker_connections限制）。

requests
客户端请求总数。

Reading
当前nginx正在读取请求头的连接数。

Writing
当前nginx正在写响应的连接数。

Waiting
当前等待请求的空闲客户端连接数。

内嵌变量
ngx_http_stub_status_module模块支持下面的内嵌变量（1.3.14+）：

$connections_active
与Active connections值相同

$connections_reading
与Reading值相同

$connections_writing
与Writing值相同

$connections_waiting
与Waiting值相同