Nginx模块
一、编译添加新模块
1.简介与思路
当前适用于nginx已经在安装过了，如果没安装过，直接在编译时候添加模块即可。
Nginx主要程序就是nginx这个二进制脚本，只要在编译一个nginx脚本替换掉原来的即可。当前操作是添加echo这个模块。
2.环境准备
系统：centos7.4一台
软件版本：1.6.0
部署目录：/usr/local/nginx
3.安装
1）echo模块可以输出文字，下载解压即可
[root@nginx ~]# wget https://github.com/openresty/echo-nginx-module/archive/v0.60.tar.gz
[root@nginx ~]# tar xf v0.60.tar.gz
建立一个模块仓库，因为添加模块后，那个文件夹要位置固定，不能删除的
[root@nginx ~]# mkdir /usr/local/nginx/module
[root@nginx ~]# mv echo-nginx-module-0.60 /usr/local/nginx/module/
2)查询当前nginx编译模块
[root@nginx ~]# nginx -V
3)找到nginx源码包目录，将原来的都填写上，最后—add-module是添加模块，指定模块文件夹位置即可
[root@nginx ~]# ./configure --prefix=/usr/local/nginx --user=nginx --group=nginx --with-http_ssl_module --with-http_spdy_module --with-http_stub_status_module --with-pcre --add-module=/usr/local/nginx/module/echo-nginx-module-0.60/
4)编译，不要install，不然覆盖了，注意看状态，最后没有error就行了
[root@nginx ~]# make
5)替换
make后将在当前nginx源码文件夹下有个objs文件夹，里面有个nginx这个文件，这个就是nginx -V时用的命令
备份命令
[root@nginx ~]# cp /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak
替换掉
[root@nginx ~]# cp objs/nginx /usr/local/nginx/sbin
4.使用验证
1)进到脚本目录
[root@nginx ~]# cd /usr/local/nginx/sbin
2)检查配置文件是否显示ok
[root@nginx ~]# nginx -t
3)重新加载配置
[root@nginx ~]# /usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx.conf
4)重新加载
[root@nginx ~]# nginx -s reload
5)检查是否编译进去，和原来的做对比。
[root@nginx ~]# nginx -V
二、yum添加新模块
1.简介
有的Nginx是yum安装的，这时候要添加新模块就比较麻烦了。
原理：
找一个同版本的nginx源码包，将nginx这个命令编译出来，和yum的替换即可。
2.配置
找一个同版本的nginx源码包
记录好原先yum安装的nginx都有哪些模块 nginx -V查看
然后将同版本nginx源码包进行编译
./configure - -之前nginx -V查看的参数 添加你需要新加入的参数 - -prefix=/tmp/nginx或者一个临时目录
make
make install
将/tmp/nginx/bin/nginx 复制出来
将/usr/bin/nginx 进行备份或者直接mv
然后将/tmp/nginx/bin/nginx 复制到/usr/bin下面
现在nginx -V 就是正确的了。
三、监控模块
1.介绍
Nginx中的stub_status模块主要用于查看Nginx的一些状态信息.
当前默认在nginx的源码文件中，不需要单独下载.
2.使用
本模块默认是不会编译进Nginx的,如果你要使用该模块,则要在编译安装Nginx时指定:
./configure –-with-http_stub_status_module
在server板块中添加一个location，访问127.0.0.1/nginx-status将会出现状态信息，里面记录nginx处理链接数等等。
#放在某个开放的server区块，填写一个location
server{
location /nginx-status {
allow -------- #允许的ip，不然都能看了，一般允许本地
deny all; #默认最后全拒绝，除了allow的
stub_status on;
access_log off；
}
}
3.参数
然后请求www.domain.com/nginx-status 就行了，下面是结果
Active connections: 5
server accepts handled requests
5970806143 5970806143 7560482010
Reading: 0 Writing: 5 Waiting: 0
Active connections: 对后端发起的活动连接数.
Server accepts handled requests: Nginx总共处理了38810620个连接,成功创建38810620次握手(证明中间没有失败的),总共处理了298655730个请求.
Reading: Nginx 读取到客户端的Header信息数.
Writing: Nginx 返回给客户端的Header信息数.
Waiting: 开启keep-alive的情况下,这个值等于 active – (reading + writing),意思就是Nginx已经处理完成,正在等候下一次请求指令的驻留连接.
所以,在访问效率高,请求很快被处理完毕的情况下,Waiting数比较多是正常的.如果reading +writing数较多,则说明并发访问量非常大,正在处理过程中.
四、健康检查
1.介绍
大家都知道，前端nginx做反代，如果后端服务器宕掉的话，nginx是不能把这台realserver剔除upstream的，所以还会有请求转发到后端的这台realserver上面去，虽然nginx可以在localtion中启用proxy_next_upstream来解决返回给用户的错误页面，但这个还是会把请求转发给这台服务器的，然后再转发给别的服务器，这样就浪费了一次转发，这次借助与淘宝技术团队开发的nginx模快nginx_upstream_check_module来检测后方realserver的健康状态，如果后端服务器不可用，则所以的请求不转发到这台服务器
2.使用
1）下载，当前下载0.3版本
wget https://github.com/yaoweibin/nginx_upstream_check_module/archive/v0.3.0.tar.gz --add-module=/xxx
2)添加
在http区块添加
upstream web_pool {
server 192.168.1.11:8080;
server 192.168.1.12:8080;
}
在server区块添加
server {
listen 80;
server_name xx;
location / {
proxy_pass http://web_pool;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
location /status { #可以图形查询到节点状态和一些信息
check_status; #访问http://xxxx/status可以查询
access_log off;
#allow all;
#deny all;
}
3.参数
1)upstream
upstream web_pool {
zone test_pool 64k;
server 192.168.1.128:8080;
server 192.168.1.129:8080;
check interval=3000 rise=2 fall=3 timeout=3000 type=http;
#interval检测间隔时间，默认毫秒，当前3秒
#rise表示请求2次，正常认为节点正常
#fall表示请求失败3次，则认为节点失败
#timout超时时间，默认毫秒，当前3秒
#type，类型，当前http类型
check_http_send "GET /status.html HTTP/1.0\r\n\r\n";
check_http_expect_alive http_2xx http_3xx;
#分发节点轮询检测后端节点的url/status.html ，如果返回2xx或者3xx认为正常，否则认为失败一次
}
五、输出模块
1.简介
官网
Nginx-echo可以在Nginx中用来输出一些信息，是在测试排错过程中一个比较好的工具。它也可以做到把来自不同链接地址的信息进行一个汇总输出。总之能用起来可以给开发人员带来挺大帮助的。下面看看我们如何去安装使用它。
二.使用
1.下载，这里下载0.56版本
wget https://github.com/openresty/echo-nginx-module/archive/v0.59.tar.gz
编辑参数添加如下，/xxx是文件解压后的路径
--add-module=/xxx
2.在location板块添加
location / {
echo “撒大大”;
}
