• 1. 介绍
  • 2. 安装
  • 3. 使用

    1. 介绍

    nginx是分成一个个模块的,比如core模块,gzip模块(ngx_http_gzip_static_module),proxy模块(ngx_http_proxy_module),每个模块负责不同的功能,例如ngx_http_gzip_static_module负责压缩,ngx_http_proxy_module负责反向代理的请求,除了基本的模块,有些模块可以选择编译或不编译进nginx。官网文档中的Modules reference部分列出了nginx源码包的所有模块。我们可以按照自己的需要定制出一个最适合自己的nginx服务器。假如需要gzip模块,那在编译的时候,可以这样指定。

    1. ./configure --with-http_gzip_static_module

    假如不需要fastcgi这个模块,可以这样:

    1. ./configure --without-http_fastcgi_module

    2. 安装

    除了源码包提供了各种模块,nginx还有各种各样的第三方模块。官方文档NGINX 3rd Party Modules列出了nginx的很多第三方模块,除此之外,很多很有用的模块也能在github等网站上找到。

    这些模块提供着各种各样意想不到的功能,有时候我们在语言层面办不好或不好办的事,交给nginx的第三方模块,可能会有惊喜。

    我们以这个模块nginx-module-vts作为例子,来演示一下如果来安装第三方模块和简单的使用。

    先把模块的源码下载下来。

    1. $ git clone git://github.com/vozlt/nginx-module-vts.git

    配置各种参数,最主要是--add-module那一行。

    1. ./configure \
    2. --user=nginx \
    3. --group=nginx \
    4. --prefix=/etc/nginx \
    5. --sbin-path=/usr/sbin/nginx \
    6. --conf-path=/etc/nginx/nginx.conf \
    7. --pid-path=/var/run/nginx.pid \
    8. --lock-path=/var/run/nginx.lock \
    9. --error-log-path=/var/log/nginx/error.log \
    10. --http-log-path=/var/log/nginx/access.log \
    11. --with-http_gzip_static_module \
    12. --with-http_stub_status_module \
    13. --with-http_ssl_module \
    14. --with-pcre \
    15. --with-file-aio \
    16. --with-http_realip_module \
    17. --without-http_scgi_module \
    18. --without-http_uwsgi_module \
    19. --without-http_fastcgi_module \
    20. --add-module=/home/yinsigan/nginx-module-vts

    --add-module是接刚才下载的模块的绝对路径。

    编译安装。

    1. $ make
    2. $ sudo make install
    3. # 升级可执行文件nginx和重启服务
    4. $ sudo make upgrade

    要检测是否成功安装的话,使用nginx -V命令即可。

    1. $ nginx -V
    2. nginx version: nginx/1.8.0
    3. built by gcc 4.8.2 (Ubuntu 4.8.2-19ubuntu1)
    4. built with OpenSSL 1.0.1f 6 Jan 2014
    5. TLS SNI support enabled
    6. configure arguments: --user=nginx --group=nginx --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --conf-path=/etc/nginx/nginx.conf --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --with-http_gzip_static_module --with-http_stub_status_module --with-http_ssl_module --with-pcre --with-file-aio --with-http_realip_module --without-http_scgi_module --without-http_uwsgi_module --without-http_fastcgi_module --add-module=/home/yinsigan/codes/nginx-module-vts --add-module=/home/yinsigan/codes/nginx-module-url

    出现了nginx-module-vts,说明安装成功了。

    这是添加一种module的情况,假如需要添加很多个module呢,那就再增加一个—add-module就好了。

    3. 使用

    语法很简单,分别在http和server部分添加几行指令。

    1. http {
    2. vhost_traffic_status_zone;
    3. ...
    4. server {
    5. ...
    6. location /status {
    7. vhost_traffic_status_display;
    8. vhost_traffic_status_display_format html;
    9. }
    10. }
    11. }

    运行sudo nginx -s reload让配置生效。之后通过浏览器访问http://127.0.0.1/status就可以看到效果了。

    6. 编译第三方模块 - 图1

    可以看到,这个模块是用来监控nginx的运行情况的,比如反向代理的服务器,cache等情况。

    本篇的重点不在于该模块的使用,具体地可以查看官方readme文档,后绪会推出其他模块介绍与使用的文章。

    完结。