1. 简介

　　　　lua-nginx-module（ngx_lua module）把 Lua5.1 的解释器 或 LuaJIT 2.0/2.1 的解释器嵌入到 nginx 中，将强大的 Lua 线程（Lua threads）与 nginx 事务模型（Nginx event model）相结合，我们可以更轻易的改变 子请求（subrequests）的处理过程。

　　　　与 Apache's mod_lua 和 Lighttpd's mod_magnet 不同，通过此模块执行的 Lua 代码是非阻塞的，同时此模块提供的 Nginx API for Lua 可以处理上游服务，比如 MySQL, PostgreSQL, Memcached, Redis,  upstream HTTP web services。

　　　　ngx_lua 可以与下面的 Lua 库、nginx 模块结合：

• • lua-resty-memcached
  • lua-resty-mysql
  • lua-resty-redis
  • lua-resty-dns
  • lua-resty-upload
  • lua-resty-websocket
  • lua-resty-lock
  • lua-resty-logger-socket
  • lua-resty-lrucache
  • lua-resty-string
  • ngx_memc
  • ngx_postgres
  • ngx_redis2
  • ngx_redis
  • ngx_proxy
  • ngx_fastcgi

     

　　　　通过 ngx.location.capture 或 ngx.location.capture_multi   的方式， ngx_lua 可以使用几乎所有的 nginx 模块。推荐使用 lua-resty-*库的方式访问 nginx 的上游模块，而不是创建子请求的方式，使用前者会更灵活、更有效的使用内存。

　　　　在 nginx 的一个 worker 里，所有请求共享一个Lua 解释器或 LuaJIT 实例，即一个 nginx worker，一个 Lua 解释器或 LuaJIT 实例。每个请求的上下文（context）是通过轻量级的 Lua 协程（coroutines）相互隔离的。

　　　　加载的 Lua 模块驻留在 nginx worker 进程级别，这样在负载很高的情况下，Lua 本身只是用了很低的内存。

　　　　由于此模块是 nginx “http” 系统的插件，所以只能以 HTTP 协议族的方式（HTTP 0.9/1.0/1.1/2.0,WebSocket）与下游通信。如果想使用 TCP 通信，可以使用与 Lua API 兼容的 ngx_stream_lua

　　2.  使用场景

• 　　使用 Lua 处理或混合 nginx 上游的各种输出；
• 　　在请求到达 nginx 上游之前，使用 Lua 进行复杂的访问控制，安全检查；
• 　　使用 Lua 操作请求的响应头；
•       从外部存储（redis、memcached、mysql...）获取信息来动态决定访问哪一个上游；
•       以非阻塞的方式从存储中获取信息生成复杂的Web 应用内容
•       使用Lua 在 重定向阶段（rewrite phase）进行复杂的 URL 路由
•       使用 Lua 实现 nginx 子请求或 location 模块的高级缓存机制；
•      ...

　　ngx_lua 即提供了脚本的灵活性，又有与 C 语言可比肩的性能（CPU ，内存）——寻妖启用 LuaJIT2.x。

　　3.  与 nginx 的兼容性

　　　　ngx_lua 模块的最新版本兼容以下的 nginx：

• • 1.11.x (last tested: 1.11.2)
  • 1.10.x
  • 1.9.x (last tested: 1.9.15)
  • 1.8.x
  • 1.7.x (last tested: 1.7.10)
  • 1.6.x

　　4. 安装

　　　　推荐使用 OpenResty releases 的发行版（整合了 nginx，ngx_lua ，LuaJIT 2.1 还有其他强大的 nginx 模块 和 Lua 库）

　　　　4.1 Ubuntu 安装 Openresty 的发行版

　　　　　　在 Ubuntu系统中添加 Openresty 的 APT 仓库，以便于安装或更新

# 导入 Openresty 的 GPG 密钥：wget -qO - https://openresty.org/package/pubkey.gpg | sudo apt-key add -# 安装 add-apt-repository 命令# （之后可以删除这个包以及对应的关联包）sudo apt-get -y install software-properties-common# 添加官方 official APT 仓库：sudo add-apt-repository -y "deb $(lsb_release -sc) main"# 更新 APT 索引：sudo apt-get update# 安装sudo apt-get install openresty#这个包同时也推荐安装 openresty-opm 和 openresty-restydoc 包，所以后面两个包会缺省安装上。 如果不想自动关联安装，可以用下面方法关闭自动关联安装：#sudo apt-get install --no-install-recommends openresty

　　　　4.2 Debian Jessie 及以上

　　　　　　与 Ubuntu相似，注意不同点 ：

 1  # 导入 GPG 密钥： 2  wget -qO - https://openresty.org/package/pubkey.gpg | sudo apt-key add - 3  4  # 安装 add-apt-repository 命令 5  # （之后你可以删除这个包以及对应的关联包） 6  sudo apt-get -y install software-properties-common 7  8  # 添加我们官方 official APT 仓库： （与 Ubuntu 不同） 9  sudo add-apt-repository -y "deb $(lsb_release -sc) openresty"10 11  # 更新 APT 索引：12  sudo apt-get update13 14  # 然后就可以像下面这样安装软件包，比如 openresty：15 16  sudo apt-get install openresty17 18  # 这个包同时也推荐安装 openresty-opm 和 openresty-restydoc 包，所以后面两个包会缺省安装上。 如果你不想自动关联安装，可以用下面方法关闭自动关联安装：19 20  sudo apt-get install --no-install-recommends openresty

　　　　4.3 Debian Wheezy

 1  # 导入 GPG 密钥： 2  wget -qO - https://openresty.org/package/pubkey.gpg | sudo apt-key add - 3  4  # 安装 add-apt-repository 命令：（与其他版本不同） 5  # （之后你可以删除这个包以及对应的关联包） 6  sudo apt-get -y install python-software-properties 7  8  # 打开 wheezy-backports 仓库： 9  sudo add-apt-repository -y "deb wheezy-backports main"10 11  # 添加官方 APT 仓库12  sudo add-apt-repository -y "deb $(lsb_release -sc) openresty"13 14  # 更新 APT 索引：15  sudo apt-get update16 17  # 然后就可以像下面这样安装包了，比如装 openresty：18 19  sudo apt-get install openresty20 21  # 这个包同时也推荐安装 openresty-opm 和 openresty-restydoc 包，所以后面两个包会缺省安装上。 如果你不想自动关联安装，可以用下面方法关闭自动关联安装：22 23  sudo apt-get install --no-install-recommends openresty

 　　　　4.4 Centos

 1  # 下面的命令就可以添加仓库： 2  sudo yum install yum-utils 3  sudo yum-config-manager --add-repo https://openresty.org/package/centos/openresty.repo 4  5  # 然后就可以像下面这样安装软件包，比如 openresty： 6  7  sudo yum install openresty 8  9  # 如果你想安装命令行工具 resty，那么可以像下面这样安装 openresty-resty 包：10 11  sudo yum install openresty-resty12 13  # 命令行工具 opm 在 openresty-opm 包里，而 restydoc 工具在 openresty-doc 包里头。14 15  # 列出所有 openresty 仓库里头的软件包：16 17  sudo yum --disablerepo="*" --enablerepo="openresty" list available

 　　　　4.5 其他版本操作系统

　　　　　　　参考官方文档

原标题：nginx扩展——lua

关键词：nginx