Nginx模块说明

1、Nginx内置模块

-–prefix=  #指向安装目录 -–sbin-path #指向(执行)程序文件(nginx) -–conf-path= #指向配置文件(nginx.conf) -–error-log-path= #指向错误日志目录 -–pid-path= #指向pid 文件(nginx.pid) -–lock-path= #指向 lock 文件(nginx.lock)(安装文件锁定,防止安装文件被别人利用,或本身误操做。) -–user= #指定程序运行时的非特权用户 -–group= #指定程序运行时的非特权用户组 -–builddir= #指向编译目录 -–with-rtsig_module #启用 rtsig 模块支持(实时信号) -–with-select_module #启用 select 模块支持(一种轮询模式,不推荐在高载环境下使用)禁用: –withoutselect_module -–with-poll_module #启用 poll 模块支持(功能与 select 相同,与 select 特性相同,为一种轮询模式,不推荐在高载环境下使用) -–with-file-aio #启用 file aio 支持(一种 APL 文件传输格式) -–with-ipv6 #启用 ipv6 支持 -–with-http_ssl_module #启用ngx_http_ssl_module 支持(使支持 https 请求,需已安装 openssl) -–with-http_realip_module #启用 ngx_http_realip_module 支持(这个模块容许从请求标头更改客户端的 IP 地址值,默认为关) -–with-http_addition_module #启用 ngx_http_addition_module 支持(做为一个输出过滤器,支持不彻底缓冲,分部分响应请求) -–with-http_xslt_module #启用 ngx_http_xslt_module 支持(过滤转换 XML 请求) -–with-http_image_filter_module 启用 ngx_http_image_filter_module 支持(传输JPEG/GIF/PNG 图片的一个过滤器)(默认为不启用。 gd 库要用到) -–with-http_geoip_module #启用 ngx_http_geoip_module 支持(该模块建立基于与 MaxMind GeoIP 二进制文件相配的客户端 IP 地址的 ngx_http_geoip_module 变量) -–with-http_sub_module #启用 ngx_http_sub_module 支持(容许用一些其余文本替换 nginx 响应中的一些文本) -–with-http_dav_module #启用 ngx_http_dav_module 支持(增长 PUT,DELETE,MKCOL:建立集合,COPY 和 MOVE 方法)默认状况下为关闭,需编译开启 -–with-http_flv_module # 启用 ngx_http_flv_module 支持(提供寻求内存使用基于时间的偏移量文件) -–with-http_gzip_static_module #启用 ngx_http_gzip_static_module 支持(在线实时压缩输出数据流) -–with-http_random_index_module #启用 ngx_http_random_index_module 支持(从目录中随机挑选一个目录索 引) -–with-http_secure_link_module #启用 ngx_http_secure_link_module 支持(计算和检查要求所需的安全连接网址) –with-http_degradation_module #启用 ngx_http_degradation_module 支持(容许在内存不足的状况下返回204 或 444 码) -–with-http_stub_status_module #启用 ngx_http_stub_status_module 支持(获取 nginx 自上次启动以来的工做状态) -–without-http_charset_module #禁用 ngx_http_charset_module 支持(从新编码 web 页面,但只能是一个方向服务器端到客户端,而且只有一个字节的编码能够被从新编码) -–without-http_gzip_module #禁用 ngx_http_gzip_module 支持(该模块同-with-http_gzip_static_module 功能同样) -–without-http_ssi_module #禁用 ngx_http_ssi_module 支持(该模块提供了一个在输入端处理处理服务器包含文件(SSI)的过滤器,目前支持 SSI 命令的列表是不完整的) -–without-http_userid_module #禁用 ngx_http_userid_module 支持(该模块用来处理用来肯定客户端后续请求的 cookies) -–without-http_access_module #禁用 ngx_http_access_module 支持(该模块提供了一个简单的基于主机的访问控制。容许/拒绝基于 ip 地址) -–without-http_auth_basic_module #禁用 ngx_http_auth_basic_module(该模块是可使用用户名和密码基于http 基本认证方法来保护你的站点或其部份内容) -–without-http_autoindex_module #禁用 disable ngx_http_autoindex_module 支持(该模块用于自动生成目录列表,只在 ngx_http_index_module 模块未找到索引文件时发出请求。) -–without-http_geo_module #禁用 ngx_http_geo_module 支持(建立一些变量,其值依赖于客户端的 IP 地址) -–without-http_map_module # 禁用 ngx_http_map_module 支持(使用任意的键/值对设置配置变量) -–without-http_split_clients_module #禁用 ngx_http_split_clients_module 支持(该模块用来基于某些条件划分用户。条件如: ip 地址、报头、 cookies 等等) -–without-http_referer_module #禁用 disable ngx_http_referer_module 支持(该模块用来过滤请求,拒绝报头中 Referer 值不正确的请求) -–without-http_rewrite_module #禁用 ngx_http_rewrite_module 支持(该模块容许使用正则表达式改变 URI,而且根据变量来转向以及选择配置。若是在 server 级别设置该选项, 那么他们将在 location 以前生效。若是在location 还有更进一步的重写规则, location 部分的规则依然会被执行。若是这个 URI 重写是由于 location 部分的规则形成的,那么 location 部分会再次被执行做为新的 URI。 这个循环会执行 10 次,而后 Nginx 会返回一个 500 错误。) -–without-http_proxy_module #禁用 ngx_http_proxy_module 支持(有关代理服务器) -–without-http_fastcgi_module #禁用 ngx_http_fastcgi_module 支持(该模块容许 Nginx 与 FastCGI 进程交互,并经过传递参数来控制 FastCGI 进程工做。 ) FastCGI 一个常驻型的公共网关接口。 -–without-http_uwsgi_module #禁用 ngx_http_uwsgi_module 支持(该模块用来医用 uwsgi 协议, uWSGI 服务器相关) -–without-http_scgi_module #禁用 ngx_http_scgi_module 支持(该模块用来启用 SCGI 协议支持, SCGI 协议是CGI 协议的替代。它是一种应用程序与 HTTP 服务接口标准。它有些像 FastCGI 但他的设计 更容易实现。) -–without-http_memcached_module #禁用 ngx_http_memcached_module 支持(该模块用来提供简单的缓存,以提升系统效率) --without-http_limit_zone_module #禁用 ngx_http_limit_zone_module 支持(该模块能够针对条件,进行会话的并发链接数控制) -–without-http_limit_req_module #禁用 ngx_http_limit_req_module 支持(该模块容许你对于一个地址进行请求数量的限制用一个给定的 session 或一个特定的事件) -–without-http_empty_gif_module #禁用 ngx_http_empty_gif_module 支持(该模块在内存中常驻了一个 1*1 的透明 GIF 图像,能够被很是快速的调用) -–without-http_browser_module #禁用 ngx_http_browser_module 支持(该模块用来建立依赖于请求报头的值。若是浏览器为 modern ,则$modern_browser 等于 modern_browser_value 指令分配的值;如 果浏览器为 old,则$ancient_browser 等于 ancient_browser_value 指令分配的值;若是浏览器为 MSIE 中的任意版本,则 $msie 等于 1) -–without-http_upstream_ip_hash_module #禁用 ngx_http_upstream_ip_hash_module 支持(该模块用于简单的负载均衡) -–with-http_perl_module #启用 ngx_http_perl_module 支持(该模块使 nginx 能够直接使用 perl 或经过 ssi 调用 perl) -–with-perl_modules_path= #设定 perl 模块路径 -–with-perl= #设定 perl 库文件路径 -–http-log-path= #设定 access log 路径 -–http-client-body-temp-path= #设定 http 客户端请求临时文件路径 -–http-proxy-temp-path= #设定 http 代理临时文件路径 -–http-fastcgi-temp-path= #设定 http fastcgi 临时文件路径 -–http-uwsgi-temp-path= #设定 http uwsgi 临时文件路径 -–http-scgi-temp-path= #设定 http scgi 临时文件路径 --without-http #禁用 http server 功能 -–without-http-cache #禁用 http cache 功能 -–with-mail #启用 POP3/IMAP4/SMTP 代理模块支持 -–with-mail_ssl_module #启用 ngx_mail_ssl_module 支持 -–without-mail_pop3_module #禁用 pop3 协议(POP3 即邮局协议的第 3 个版本,它是规定我的计算机如何链接到互联网上的邮件服务器进行收发邮件的协议。是因特网电子邮件的第一个离线协议标 准,POP3 协议容许用户从服务器上把邮件存储到本地主机上,同时根据客户端的操做删除或保存在邮件服务器上的邮件。 POP3 协议是 TCP/IP 协议族中的一员,主要用于 支持使用客户端远程管理在服务器上的电子邮件) -–without-mail_imap_module #禁用 imap 协议(一种邮件获取协议。它的主要做用是邮件客户端能够经过这种协议从邮件服务器上获取邮件的信息,下载邮件等。 IMAP 协议运行在 TCP/IP 协议之上, 使用的端口是 143。它与POP3 协议的主要区别是用户能够不用把全部的邮件所有下载,能够经过客户端直接对服务器上的邮件进行操做。) -–without-mail_smtp_module #禁用 smtp 协议(SMTP 即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则,由它来控制信件的中转方式。 SMTP 协议属于 TCP/IP 协议族,它帮助每台计算机在发送或中转信件时找到下一个目的地。) -–with-google_perftools_module #启用 ngx_google_perftools_module 支持(调试用,剖析程序性能瓶颈) -–with-cpp_test_module # 启用 ngx_cpp_test_module 支持 -–add-module= #启用外部模块支持 -–with-cc= #指向 C 编译器路径 -–with-cpp= #指向 C 预处理路径 -–with-cc-opt= #设置 C 编译器参数(PCRE 库,须要指定–with-cc-opt=” -I /usr/local/include”,若是使用select()函数则须要同时增长文件描述符数量,能够经过–with-cc- opt=” -D FD_SETSIZE=2048”指定。) -–with-ld-opt= #设置链接文件参数。(PCRE 库,须要指定–with-ld-opt=” -L /usr/local/lib”。) -–with-cpu-opt= #指定编译的 CPU,可用的值为: pentium, pentiumpro, pentium3, pentium4, athlon,opteron, amd64, sparc32, sparc64, ppc64 -–without-pcre #禁用 pcre 库 -–with-pcre #启用 pcre 库 -–with-pcre= #指向 pcre 库文件目录 -–with-pcre-opt= #在编译时为 pcre 库设置附加参数 -–with-md5= #指向 md5 库文件目录(消息摘要算法第五版,用以提供消息的完整性保护) -–with-md5-opt= #在编译时为 md5 库设置附加参数 -–with-md5-asm #使用 md5 汇编源 -–with-sha1= #指向 sha1 库目录(数字签名算法,主要用于数字签名) -–with-sha1-opt= #在编译时为 sha1 库设置附加参数 -–with-sha1-asm #使用 sha1 汇编源 -–with-zlib= #指向 zlib 库目录 -–with-zlib-opt= #在编译时为 zlib 设置附加参数 -–with-zlib-asm= #为指定的 CPU 使用 zlib 汇编源进行优化, CPU 类型为 pentium, pentiumpro -–with-libatomic #为原子内存的更新操做的实现提供一个架构 -–with-libatomic= #指向 libatomic_ops 安装目录 -–with-openssl= #指向 openssl 安装目录 -–with-openssl-opt #在编译时为 openssl 设置附加参数 -–with-debug #启用 debug 日志

2、Nginx编译添加新模块

1.简介与思路

当前适用于nginx已经在安装过了,若是没安装过,直接在编译时候添加模块便可。html

Nginx主要程序就是nginx这个二进制脚本,只要在编译一个nginx脚本替换掉原来的便可。当前操做是添加echo这个模块。前端

2.环境准备

系统:centos7.3一台
软件版本:1.8.0
部署目录:/usr/local/nginxpython

3.安装

1.echo模块能够输出文字,下载解压便可
wget https://github.com/openresty/echo-nginx-module/archive/v0.60.tar.gz
tar xf v0.60.tar.gznginx

创建一个模块仓库,由于添加模块后,那个文件夹要位置固定,不能删除的
mkdir /usr/local/nginx/module
mv echo-nginx-module-0.60 /usr/local/nginx/module/git

2.查询当前nginx编译模块
nginx -Vgithub

3.找到nginx源码包目录,将原来的都填写上,最后–add-module是添加模块,指定模块文件夹位置便可
./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/web

4.编译,不要install,否则覆盖了,注意看状态,最后没有error就好了
make正则表达式

5.替换
make后将在当前nginx源码文件夹下有个objs文件夹,里面有个nginx这个文件,这个就是nginx -V时用的命令
备份命令
cp /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak算法

替换掉
cp objs/nginx /usr/local/nginx/sbin后端

4.使用验证

进到脚本目录
cd /usr/local/nginx/sbin

检查配置文件是否显示ok
nginx -t

从新加载
nginx -s reload

检查是否编译进去,和原来的作对比。
nginx -V

3、YUM安装Nginx添加模块

找一个同版本的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 就是正确的了。

4、Nginx外置模块

1、监控模块 stub_status

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数较多,则说明并发访问量很是大,正在处理过程当中.

2、健康检查模块 nginx_upstream_check_module

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.11:8080; server 192.168.1.12: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认为正常,不然认为失败一次 }

3、输出模块_echo

1.简介

官网
Nginx-echo能够在Nginx中用来输出一些信息,是在测试排错过程当中一个比较好的工具。它也能够作到把来自不一样连接地址的信息进行一个汇总输出。总之能用起来能够给开发人员带来挺大帮助的。下面看看咱们如何去安装使用它。

2.使用

1.下载,这里下载0.56版本
wget https://github.com/openresty/echo-nginx-module/archive/v0.56.tar.gz
--add-module=/xxx

2.在location板块添加

location / { echo “撒大大”; }

相关文章
相关标签/搜索