阿里云Centos版本搭建Nginx+lua

第一步：创建目录

/usr/servers，以后我们把所有软件安装在此目录

mkdir -p /usr/servers  
cd /usr/servers/

第二步：安装依赖

首先检查一下自己的版本信息，方便安装对应的依赖

首先检查一下是否按章了gcc环境，如果出现下图即可

没有出现请使用下述指令安装gcc依赖

yum install gcc-c++

出现之后，输入

gcc -v

打印gcc版本信息

发现是小红帽之后，去官网：http://openresty.org/cn/installation.html

发现我们需要安装的依赖在这：

因此输入：

yum install pcre-devel openssl-devel gcc curl

第三步：下载ngx_openresty-1.7.7.2.tar.gz并解压

wget http://openresty.org/download/ngx_openresty-1.7.7.2.tar.gz

tar -xzvf ngx_openresty-1.7.7.2.tar.gz

第四步：安装LuaJIT

cd ngx_openresty-1.7.7.2
cd bundle//LuaJIT-2.1-20150120/
make clean && make && make install

ln -sf luajit-2.1.0-alpha /usr/local/bin/luajit

第五步：下载ngx_cache_purge模块，该模块用于清理nginx缓存

wget https://github.com/FRiCKLE/ngx_cache_purge/archive/2.3.tar.gz

tar -xvf 2.3.tar.gz

第六步：下载nginx_upstream_check_module模块，该模块用于ustream健康检查

第七步：安装ngx_openresty

cd /usr/servers/ngx_openresty-1.7.7.2/bundle  

wget https://github.com/yaoweibin/nginx_upstream_check_module/archive/v0.3.0.tar.gz  

tar -xvf v0.3.0.tar.gz

【说明】

--with*** 安装一些内置/集成的模块

--with-http_realip_module 取用户真实ip模块

-with-pcre Perl兼容的达式模块

--with-luajit 集成luajit模块

--add-module 添加自定义的第三方模块，如此次的ngx_che_purge

make && make install

（此处我粘贴提示指令未发现，可能是输入法造成不识别）安装时间比较久，大概两分钟

第八步：到/usr/servers目录下

cd /usr/servers/  

ll

会发现多出来了如下目录，说明安装成功

目录	解释
/usr/servers/luajit	luajit环境，luajit类似于java的jit，即即时编译，lua是一种解释语言，通过luajit可以即时编译lua代码到机器代码，得到很好的性能
/usr/servers/lualib	要使用的lua库，里边提供了一些默认的lua库，如redis，json库等，也可以把一些自己开发的或第三方的放在这
/usr/servers/nginx	安装的nginx

通过/usr/servers/nginx/sbin/nginx -V 查看nginx版本和安装的模块

第九步：启动nginx

/usr/servers/nginx/sbin/nginx

接下来该配置nginx+lua开发环境了

1、编辑nginx.conf配置文件

vim /usr/servers/nginx/conf/nginx.conf

2、在http部分添加如下配置

#lua模块路径，多个之间”;”分隔，其中”;;”表示默认搜索路径，默认到/usr/servers/nginx下找  

lua_package_path "/usr/servers/lualib/?.lua;;";  #lua 模块  

lua_package_cpath "/usr/servers/lualib/?.so;;";  #c模块

3、为了方便开发我们在/usr/servers/nginx/conf目录下创建一个lua.conf

vi lua.conf

#lua.conf  
server {  
    listen       80;  
    server_name  _;  
}

4、在nginx.conf中的http部分添加include lua.conf包含此文件片段

include lua.conf;

5、测试是否正常

/usr/servers/nginx/sbin/nginx  -t

如果显示如下内容说明配置成功

nginx: the configuration file /usr/servers/nginx/conf/nginx.conf syntax is ok

nginx: configuration file /usr/servers/nginx/conf/nginx.conf test is successful

HelloWorld

1、在lua.conf中server部分添加如下配置

location /lua {  

    default_type 'text/html';  

        content_by_lua 'ngx.say("hello world")';  

}

测试配置是否正确

/usr/servers/nginx/sbin/nginx  -t

(这里我因为 } 的中英文格式修改了一会，注意按报错信息修改即可，我的错误信息如下)

错误信息：

正确如下

3、重启nginx

/usr/servers/nginx/sbin/nginx -s reload

4、访问如http://192.168.1.6/lua（自己的机器根据实际情况换ip），可以看到如下内容

5、lua代码文件

我们把lua代码放在nginx配置中会随着lua的代码的增加导致配置文件太长不好维护，因此我们应该把lua代码移到外部文件中存储。

vim /usr/servers/nginx/conf/lua/test.lua

#添加如下内容  

ngx.say("hello world");

然后lua.conf修改为

location /lua {  
    default_type 'text/html';  
    content_by_lua_file conf/lua/test.lua; #相对于nginx安装目录  
}

此处conf/lua/test.lua也可以使用绝对路径/usr/servers/nginx/conf/lua/test.lua。

6、lua_code_cache

默认情况下lua_code_cache 是开启的，即缓存lua代码，即每次lua代码变更必须reload nginx才生效，如果在开发阶段可以通过lua_code_cache off;关闭缓存，这样调试时每次修改lua代码不需要reload nginx；但是正式环境一定记得开启缓存。

location /lua {  
        default_type 'text/html';  
        lua_code_cache off;  
        content_by_lua_file conf/lua/test.lua;  
}

开启后reload nginx

会看到如下报警

nginx: [alert] lua_code_cache is off; this will hurt performance in /usr/servers/nginx/conf/lua.conf:8

7、错误日志

如果运行过程中出现错误，请不要忘记查看错误日志。

tail -f /usr/servers/nginx/logs/error.log

到此我们的基本环境搭建完毕。

nginx+lua项目构建

以后我们的nginx lua开发文件会越来越多，我们应该把其项目化，已方便开发。项目目录结构如下所示：

example

example.conf ---该项目的nginx 配置文件

lua ---我们自己的lua代码

test.lua

lualib ---lua依赖库/第三方依赖

*.lua

*.so

其中我们把lualib也放到项目中的好处就是以后部署的时候可以一起部署，防止有的服务器忘记复制依赖而造成缺少依赖的情况。

我们将项目放到到/usr/example目录下。

/usr/servers/nginx/conf/nginx.conf配置文件如下(此处我们最小化了配置文件)通过绝对路径包含我们的lua依赖库和nginx项目配置文件。

#user  nobody;  

worker_processes  2;  

error_log  logs/error.log;  

events {  

    worker_connections  1024;  

}  

http {  

    include       mime.types;  

    default_type  text/html;  

  

    #lua模块路径，其中”;;”表示默认搜索路径，默认到/usr/servers/nginx下找  

    lua_package_path "/usr/example/lualib/?.lua;;";  #lua 模块  

    lua_package_cpath "/usr/example/lualib/?.so;;";  #c模块  

    include /usr/example/example.conf;  

}

/usr/example/example.conf配置文件如下 lua文件我们使用绝对路径/usr/example/lua/test.lua。

server {  

    listen       80;  

    server_name  _;  

  

    location /lua {  

        default_type 'text/html';  

        lua_code_cache off;  

        content_by_lua_file /usr/example/lua/test.lua;  

    }  

}

到此我们就可以把example扔svn上了

现有目录结构如下：