nginx 增加 lua模块

Nginx中的stub_status模块主要用于查看Nginx的一些状态信息.

本模块默认是不会编译进Nginx的,如果你要使用该模块,则要在编译安装Nginx时指定:

./configure –with-http_stub_status_module 这个模块如果需要也可以加入

######################### 下面是 lua模块

unknown directive "access_by_lua"

unknown directive "set_unescape_uri"

之所以报错是缺少nginx的三方插件,下面介绍安装nginx的第三方插件,插件很多直介绍三个

方式一:

下载 ngx_openresty,该集成包中有:NginxLuaLuajitngx_lua,以及一些有用的Nginx第三方模块。

安装步骤:

  1. ./configure --with-luajit
  2. make
  3. make install

安装完成,个人建议第一种安装方便简单,另外这个版本还提供了很多的组件,安装不会出现错误。

方式二:

Ngx_lua手动编译进Nginx。

首先,我的 Nginx 安装路径为:/usr/local/nginx。

我将尝试编译的两个模块:echo,lua。

所需要的模块如下:

liujit http://luajit.org

lua http://www.lua.org

ngx_devel_kit https://github.com/simpl/ngx_devel_kit

echo-nginx-module https://github.com/agentzh/echo-nginx-module

lua-nginx-module https://github.com/chaoslawful/lua-nginx-module

安装步骤:

1、Luajit2.0.2(推荐)

Java代码

  1. wget http://luajit.org/download/LuaJIT-2.0.2.tar.gz
  2. tar zxvf LuaJIT-2.0.2.tar.gz
  3. cd LuaJIT-2.0.2
  4. make
  5. sudo make install

安装lua

tar-zxvf lua-5.2.0.tar.gz
cd lua-5.2.0
make linux
make install
完成安装.

如果遇到

lua.c:67:31: fatal error: readline/readline.h: No such file or directory
说明缺少libreadline-dev依赖包

centos: yum install readline-devel
debian: apt-get install libreadline-dev.

下面需要配置一下 luajit 或 lua 的环境变量(Nginx编译时需要):

Java代码

  1. -- luajit --
  2. # tell nginx's build system where to find LuaJIT:
  3. export LUAJIT_LIB=/path/to/luajit/lib
  4. export LUAJIT_INC=/path/to/luajit/include/luajit-2.0.2
  5. -- lua --
  6. # or tell where to find Lua if using Lua instead:
  7. export LUA_LIB=/path/to/lua/lib
  8. export LUA_INC=/path/to/lua/include

我的测试环境里,配置如下:

Java代码

  1. export LUAJIT_LIB=/usr/local/luajit/lib
  2. export LUAJIT_INC=/usr/local/luajit/include/luajit-2.0

2、安装 ngx_devel_kit (NDK) 模块

Java代码

  1. cd /usr/local
  2. git clone https://github.com/simpl/ngx_devel_kit.git

下载完成后,将在 /usr/local/ 目录下生成子目录 ngx_devel_kit。

3、安装 lua-nginx-module 模块

Java代码

  1. cd /usr/local
  2. git clone https://github.com/chaoslawful/lua-nginx-module.git

下载完成后,将在 /usr/local/ 目录下生成子目录 lua-nginx-module。

4、重新编译Nginx,需要注意编译顺序!

Java代码

  1. ./configure --prefix=/usr/local/nginx \
  2. --with-ld-opt="-Wl,-rpath,$LUAJIT_LIB" \
  3. --add-module=/usr/local/ngx_devel_kit \
  4. --add-module=/usr/local/echo-nginx-module \
  5. --add-module=/usr/local/lua-nginx-module
  6. make -j2
  7. make install

注释:重新编译 Nginx 二进制,Nginx 需要 quit 再启动。而普通配置更新则 reload 即可:

kill -HUP `cat /path/nginx/logs/nginx.pid`

/usr/local/nginx/sbin/nginx -s reload

模块编译成功!

重启Nginx服务器!

在编译安装 Nginx 的第三方模块时,碰到一个错误:

/usr/local/nginx/sbin/ngxin -s reload

/usr/local/nginx/sbin/nginx: error while loading shared libraries: libluajit-5.1.so.2: cannot open shared object file: No such file or directory

百事不得其解,后来Google之,发现了解决办法。

在 Nginx 编译时,需要指定 RPATH,加入下面选项即可:

./configure --with-ld-opt="-Wl,-rpath,$LUAJIT_LIB"

或者

export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH

5、测试Lua

在Nginx.conf 配置文件中,加入以下代码:

location /echo {

default_type 'text/plain';

echo 'hello echo';

}

location /lua {

default_type 'text/plain';

content_by_lua 'ngx.say("hello, lua")';

}

重启Nginx服务器:

/usr/local/nginx/sbin/nginx -s reload

使用curl测试:

[root@localhost] curl http://localhost/echo

hello echo

[root@localhost] curl http://localhost/lua

hello lua

测试结果表明,两个模块都安装成功!

简洁版

Java代码

  1. wget http://nginx.org/download/nginx-1.2.7.tar.gz
  2. wget http://luajit.org/download/LuaJIT-2.0.1.tar.gz
  3. wget https://github.com/simpl/ngx_devel_kit/archive/v0.2.18.tar.gz
  4. wget https://github.com/chaoslawful/lua-nginx-module/archive/v0.7.16.tar.gz
  5. tar xzf LuaJIT-2.0.1.tar.gz
  6. cd LuaJIT-2.0.1
  7. make
  8. make install PREFIX=/usr/local/LuaJIT/
  9. cd ..
  10. tar xzf nginx-1.2.7.tar.gz
  11. tar xzf v0.2.18.tar.gz
  12. tar xzf v0.7.16.tar.gz
  13. cd nginx-1.2.7
  14. export LUAJIT_INC=/usr/local/LuaJIT/include/luajit-2.0
  15. export LUAJIT_LIB=/usr/local/LuaJIT/lib
  16. export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH
  17. ./configure –user=www –group=www –prefix=/usr/local/webserver/nginx –with-http_stub_status_module –with-http_ssl_module –add-module=/root/software/ngx_devel_kit-0.2.18 –add-module=/root/software/lua-nginx-module-0.7.16/
  18. make
  19. make insatll
  20. ./configure --prefix=/usr/local/nginx/nginx-1.7.3 \
  21. --sbin-path=/usr/local/nginx/nginx-1.7.3 \
  22. --conf-path=/usr/local/nginx/nginx-1.7.3/conf/nginx.conf \
  23. --with-http_ssl_module \
  24. --with-openssl=/usr/local/nginx/openssl-1.0.1h \
  25. --with-pcre=/usr/local/nginx/pcre-8.33 \
  26. --with-zlib=/usr/local/nginx/zlib-1.2.8 \
  27. --with-http_stub_status_module \
  28. --add-module=/usr/local/nginx/ngx_devel_kit-0.2.18 \
  29. --add-module=/usr/local/nginx/lua-nginx-module-0.7.16 \
  30. --add-module=/usr/local/nginx/set-misc-nginx-module-0.27

另一篇文章:http://sunjun041640.blog.163.com/blog/static/2562683220134931235857/

misc-nginx-module和lua-nginx-module插件具体文档可参考如下:

https://github.com/openresty/set-misc-nginx-module/tags

https://github.com/openresty/lua-nginx-module#installation

记录日志:

Java代码

  1. user root;
  2. worker_processes 1;
  3. #error_log logs/error.log;
  4. #error_log logs/error.log notice;
  5. #error_log logs/error.log info;
  6. pid logs/nginx.pid;
  7. events {
  8. worker_connections 1024;
  9. }
  10. http {
  11. include mime.types;
  12. default_type application/octet-stream;
  13. log_format tick "$msec|||$u_t|||$remote_addr|||$u_domain|||$u_url|||$u_title|||$u_referrer|||$u_sh|||$u_sw|||$u_cd|||$u_lang|||$http_user_agent|||$u_utrace|||$u_account|||$u_time";
  14. #access_log logs/access.log main;
  15. sendfile on;
  16. #tcp_nopush on;
  17. #keepalive_timeout 0;
  18. keepalive_timeout 65;
  19. #gzip on;
  20. server {
  21. listen 80;
  22. server_name localhost;
  23. #charset koi8-r;
  24. location /1.gif {
  25. #伪装成gif文件
  26. default_type image/gif;
  27. #本身关闭access_log,通过subrequest记录log
  28. access_log off;
  29. access_by_lua "
  30. -- 用户跟踪cookie名为__utrace
  31. local uid = ngx.var.cookie___utrace
  32. if not uid then
  33. -- 如果没有则生成一个跟踪cookie,算法为md5(时间戳+IP+客户端信息)
  34. uid = ngx.md5(ngx.now() .. ngx.var.remote_addr .. ngx.var.http_user_agent)
  35. end
  36. ngx.header['Set-Cookie'] = {'__utrace=' .. uid .. '; path=/'}
  37. if ngx.var.arg_domain then
  38. -- 通过subrequest到/i-log记录日志,将参数和用户跟踪cookie带过去
  39. ngx.location.capture('/i-log?' .. ngx.var.args .. '&utrace=' .. uid .. '&time=' .. ngx.localtime())
  40. end
  41. ";
  42. #此请求不缓存
  43. add_header Expires "Fri, 01 Jan 1980 00:00:00 GMT";
  44. add_header Pragma "no-cache";
  45. add_header Cache-Control "no-cache, max-age=0, must-revalidate";
  46. #返回一个1×1的空gif图片
  47. empty_gif;
  48. }
  49. location /i-log {
  50. #内部location,不允许外部直接访问
  51. internal;
  52. #设置变量,注意需要unescape
  53. set_unescape_uri $u_domain $arg_domain;
  54. set_unescape_uri $u_t $arg_t;
  55. set_unescape_uri $u_url $arg_url;
  56. set_unescape_uri $u_title $arg_title;
  57. set_unescape_uri $u_referrer $arg_referrer;
  58. set_unescape_uri $u_sh $arg_sh;
  59. set_unescape_uri $u_sw $arg_sw;
  60. set_unescape_uri $u_cd $arg_cd;
  61. set_unescape_uri $u_lang $arg_lang;
  62. set_unescape_uri $u_utrace $arg_utrace;
  63. set_unescape_uri $u_account $arg_account;
  64. set_unescape_uri $u_time $arg_time;
  65. #打开日志
  66. log_subrequest on;
  67. #记录日志到ma.log,实际应用中最好加buffer,格式为tick
  68. access_log /usr/local/nginx/nginxlog/access.log tick;
  69. #输出空字符串
  70. echo '';
  71. }
  72. #error_page 404 /404.html;
  73. # redirect server error pages to the static page /50x.html
  74. #
  75. error_page 500 502 503 504 /50x.html;
  76. location = /50x.html {
  77. root html;
  78. }
  79. # remove the robots line if you want to use wordpress' virtual robots.txt
  80. location = /robots.txt { access_log off; log_not_found off; }
  81. location = /favicon.ico { access_log off; log_not_found off; }
  82. # this prevents hidden files (beginning with a period) from being served
  83. location ~ /\. { access_log off; log_not_found off; deny all; }
  84. }
  85. }