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，该集成包中有：Nginx，Lua或Luajit，ngx_lua，以及一些有用的Nginx第三方模块。

安装步骤：

./configure --with-luajit
make
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代码

wget http://luajit.org/download/LuaJIT-2.0.2.tar.gz
tar zxvf LuaJIT-2.0.2.tar.gz
cd LuaJIT-2.0.2
make
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代码

-- luajit --
# tell nginx's build system where to find LuaJIT:
export LUAJIT_LIB=/path/to/luajit/lib
export LUAJIT_INC=/path/to/luajit/include/luajit-2.0.2
-- lua --
# or tell where to find Lua if using Lua instead:
export LUA_LIB=/path/to/lua/lib
export LUA_INC=/path/to/lua/include

我的测试环境里，配置如下：

Java代码

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

2、安装 ngx_devel_kit (NDK) 模块

Java代码

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

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

3、安装 lua-nginx-module 模块

Java代码

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

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

4、重新编译Nginx，需要注意编译顺序！

Java代码

./configure --prefix=/usr/local/nginx \
--with-ld-opt="-Wl,-rpath,$LUAJIT_LIB" \
--add-module=/usr/local/ngx_devel_kit \
--add-module=/usr/local/echo-nginx-module \
--add-module=/usr/local/lua-nginx-module
make -j2
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代码

wget http://nginx.org/download/nginx-1.2.7.tar.gz
wget http://luajit.org/download/LuaJIT-2.0.1.tar.gz
wget https://github.com/simpl/ngx_devel_kit/archive/v0.2.18.tar.gz
wget https://github.com/chaoslawful/lua-nginx-module/archive/v0.7.16.tar.gz
tar xzf LuaJIT-2.0.1.tar.gz
cd LuaJIT-2.0.1
make
make install PREFIX=/usr/local/LuaJIT/
cd ..
tar xzf nginx-1.2.7.tar.gz
tar xzf v0.2.18.tar.gz
tar xzf v0.7.16.tar.gz
cd nginx-1.2.7
export LUAJIT_INC=/usr/local/LuaJIT/include/luajit-2.0
export LUAJIT_LIB=/usr/local/LuaJIT/lib
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH
./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/
make
make insatll
./configure --prefix=/usr/local/nginx/nginx-1.7.3 \
--sbin-path=/usr/local/nginx/nginx-1.7.3 \
--conf-path=/usr/local/nginx/nginx-1.7.3/conf/nginx.conf \
--with-http_ssl_module \
--with-openssl=/usr/local/nginx/openssl-1.0.1h \
--with-pcre=/usr/local/nginx/pcre-8.33 \
--with-zlib=/usr/local/nginx/zlib-1.2.8 \
--with-http_stub_status_module \
--add-module=/usr/local/nginx/ngx_devel_kit-0.2.18 \
--add-module=/usr/local/nginx/lua-nginx-module-0.7.16 \
--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代码

user root;
worker_processes 1;
#error_log logs/error.log;
#error_log logs/error.log notice;
#error_log logs/error.log info;
pid logs/nginx.pid;
events {
worker_connections 1024;
}
http {
include mime.types;
default_type application/octet-stream;
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";
#access_log logs/access.log main;
sendfile on;
#tcp_nopush on;
#keepalive_timeout 0;
keepalive_timeout 65;
#gzip on;
server {
listen 80;
server_name localhost;
#charset koi8-r;
location /1.gif {
#伪装成gif文件
default_type image/gif;
#本身关闭access_log，通过subrequest记录log
access_log off;
access_by_lua "
-- 用户跟踪cookie名为__utrace
local uid = ngx.var.cookie___utrace
if not uid then
-- 如果没有则生成一个跟踪cookie，算法为md5(时间戳+IP+客户端信息)
uid = ngx.md5(ngx.now() .. ngx.var.remote_addr .. ngx.var.http_user_agent)
end
ngx.header['Set-Cookie'] = {'__utrace=' .. uid .. '; path=/'}
if ngx.var.arg_domain then
-- 通过subrequest到/i-log记录日志，将参数和用户跟踪cookie带过去
ngx.location.capture('/i-log?' .. ngx.var.args .. '&utrace=' .. uid .. '&time=' .. ngx.localtime())
end
";
#此请求不缓存
add_header Expires "Fri, 01 Jan 1980 00:00:00 GMT";
add_header Pragma "no-cache";
add_header Cache-Control "no-cache, max-age=0, must-revalidate";
#返回一个1×1的空gif图片
empty_gif;
}
location /i-log {
#内部location，不允许外部直接访问
internal;
#设置变量，注意需要unescape
set_unescape_uri $u_domain $arg_domain;
set_unescape_uri $u_t $arg_t;
set_unescape_uri $u_url $arg_url;
set_unescape_uri $u_title $arg_title;
set_unescape_uri $u_referrer $arg_referrer;
set_unescape_uri $u_sh $arg_sh;
set_unescape_uri $u_sw $arg_sw;
set_unescape_uri $u_cd $arg_cd;
set_unescape_uri $u_lang $arg_lang;
set_unescape_uri $u_utrace $arg_utrace;
set_unescape_uri $u_account $arg_account;
set_unescape_uri $u_time $arg_time;
#打开日志
log_subrequest on;
#记录日志到ma.log，实际应用中最好加buffer，格式为tick
access_log /usr/local/nginx/nginxlog/access.log tick;
#输出空字符串
echo '';
}
#error_page 404 /404.html;
# redirect server error pages to the static page /50x.html
#
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
# remove the robots line if you want to use wordpress' virtual robots.txt
location = /robots.txt { access_log off; log_not_found off; }
location = /favicon.ico { access_log off; log_not_found off; }
# this prevents hidden files (beginning with a period) from being served
location ~ /\. { access_log off; log_not_found off; deny all; }
}
}

猜你喜欢