Nginx基础篇（3）- Nginx经常使用官方模块

时间 2019-11-16

标签 nginx 基础经常使用官方模块栏目 Nginx 繁體版

原文原文链接

Nginx经常使用官方模块

Nginx采用模块化的架构，Nginx中大部分功能都是经过模块方式提供的，好比HTTP模块、Mail模块等。

Nginx官方模块文档html

1. ngx_http_stub_status_module

编译选项

--with-http_stub_status_module

做用

提供Nginx当前处理链接等基本状态信息的访问nginx

语法

Syntax:        stub_status;
Default:    —
Context:    server, location

用法

在nginx配置文件中的 server 下配置

server {
    # 添加的配置
    location /nginx_status {
        stub_status;
    }
    
    ...其它代码省略...
}

修改后从新载入配置文件nginx -s reload
在浏览器中访问 http://<ip>/nginx_status，会返回以下内容

Active connections: 3 
server accepts handled requests
 7 7 16 
Reading: 0 Writing: 1 Waiting: 2

Active connections: Nginx当前活跃连接数
accepts: 接收客户端链接的总次数
handled: 处理客户端链接的总次数。通常来讲，这个参数值与accepts相同，除非已经达到了一些资源限制（例如 worker_connections限制）
requests: 客户端请求的总次数
Reading: 当前nginx正在读取请求头的链接数
Writing: 当前nginx正在写入响应的链接数
Waiting: 当前正在等待请求的空闲客户端链接数。通常是在nginx开启长链接（keep alive）状况下出现。

2. ngx_http_random_index_module

编译选项

--with-http_random_index_module

做用

在主目录中选择一个随机文件做为主页web

语法

Syntax:        random_index on | off;
Default:    random_index off;
Context:    location

用法

在nginx配置文件中的 server 下配置

server {
    location / {
        root /usr/share/nginx/html;
        #添加这一行开启随机主页模块
        random_index on;
        #把指定的主页注释掉
        #index index.html index.htm;
    }
    
    ...其它代码省略...
}

3. ngx_http_sub_module

编译选项

--with-ngx_http_sub_module

做用

经过替换一个指定的字符串来修改响应shell

语法

指定被替换的字符和替代字符浏览器

Syntax:    sub_filter string replacement;
Default:   —
Context:    http, server, location

Last-Modified，用于校验服务端内容是否更改，主要用于缓存场景缓存

Syntax:       sub_filter_last_modified on | off;
Default:   sub_filter_last_modified off;
Context:    http, server, location

默认只替换找到的第一个字符串，若替换文本中的全部匹配的字符串，则置为off架构

Syntax:       sub_filter_once on | off;
Default:    sub_filter_once on;
Context:    http, server, location

除了“text/html”以外，还能够用指定的MIME类型替换字符串。特殊值‘*’匹配任意MIME类型dom

Syntax:       sub_filter_types mime-type ...;
Default:    sub_filter_types text/html;
Context:    http, server, location

用法

在nginx配置文件中的 server 下配置

server {
    location / {
        root   /usr/share/nginx/html;
        index  index.html;
        # 将首页的nginx替换为home
        sub_filter 'nginx' 'home';
        # 不止替换第一个，而是替换response中全部的nginx
        sub_filter_once off;
    }
    
    ...其它代码省略...
}

修改后从新载入配置文件nginx -s reload
curl localhost，返回以下内容，会发现响应中全部nginx已经替换为home

[vagrant/etc/nginx]$ curl localhost
<!DOCTYPE html>
<html>
<head>
<title>Welcome to home!</title>
<style>
    body {
        width: 35em;
        margin: 0 auto;
        font-family: Tahoma, Verdana, Arial, sans-serif;
    }
</style>
</head>
<body>
<h1>Welcome to home!</h1>
<p>If you see this page, the home web server is successfully installed and
working. Further configuration is required.</p>

<p>For online documentation and support please refer to
<a href="http://home.org/">home.org</a>.<br/>
Commercial support is available at
<a href="http://home.com/">home.com</a>.</p>

<p><em>Thank you for using home.</em></p>
</body>
</html>