---

OpenResty 编译安装

---

1、OpenResty源码获取

OpenResty 当前源码版本是 1.15.8.2，集成的 Nginx 版本是 Nginx 1.15.8 版本。其源码可通过官网直接获取，获取命令如下:

mkdir -p /opt/data/source
cd /opt/data/source
wget https://openresty.org/download/openresty-1.15.8.2.tar.gz
tar zxmf openresty-1.15.8.2.tar.gz

---

2、编译配置参数

OpenResty 是 Nginx 的扩展版，其在编译配置参数上也进行了清晰的区分，分为 Nginx 原有编译配置参数和扩展编译配置参数两部分，扩展编译配置参数如下表所示。

编译参数	参数说明
--with-debug	启用调试日志
--with-dtrace-probes	启用 DTrace USDT 探针
--without-http_echo_module	不编译可以在 Nginx 的 URL 访问中通过 echo 命令输出字符到用户的浏览器，一般用来调试输出信息，检测 Nginx 的可访问性、配置正确性
--without-http_xss_module	不编译跨站点脚本支持
--without-http_coolkit_module	不编译 Nginx 插件模块集合
--without-http_set_misc_module	不编译 rewrite 指令的扩展
--without-http_form_input_module	不编译 HTTP 请求扩展
--without-http_encrypted_session_module	不编译加密解密 Nginx 变量值的模块
--without-http_srcache_module	不编译缓存增强模块
--without-http_lua_module	不编译 Lua 脚本支持模块
--without-http_lua_upstream_module	不编译提供操作 upstream 服务器 Lua API 功能的模块
--without-http_headers_more_module	不编译 header 返回信息编辑模块
--without-http_array_var_module	不编译数组类型的 Nginx 变量模块
--without-http_memc_module	不编译 Memcache 扩展模块
--without-http_redis2_module	不编译 Redis 2.0 协议支持模块
--without-http_redis_module	不编译 Redis 缓存的模块
--without-http_rds_ison_module	不编译 DBD-Stream 格式转 JSON 格式模块
--without-http_rds_csv_module	不编译 DBD-Stream 格式转 cvs 格式模块
--without-stream_lua_module	不编译 TCP/UDP 负载 Lua 脚本支持模块
--without-ngx_devel_kit_module	不编译模块开发库
--with-http_iconv_module	编译编码字符转换模块
--without-http_ssl_module	不编译 HTTP SSL 支持模块
--without-stream_ssl_module	不编译 Stream SSL 支持模块
--with-http_drizzle_module	编译 MySQL 或 Drizzle 数据库访问模块
--with-http_postgres_module	编译 PostgreSQL 数据库访问模块
--without-lua_cjson	不编译快速解析 JSON 的一个 Lua C 模块
--without-lua_tablepool	不编译基于 LuaJIT 的 Lua 表格资源回收池支持库
--without-lua_redis_parser	不编译 Redis 数据解析为 Lua 数据结构模块
--without-lua_rds_parser	不编译 DBD-Stream 格式的数据解析为 Lua 数据结构模块
--without-lua_resty_dns	不编译 DNS（域名系统）解析器的 Lua 模块
--without-lua_resty_memcached	不编译 Memcached 客户端模块
--without-lua_resty_redis	不编译 Redis 客户端模块
--without-lua_resty_mysql	不编译 MySQL 客户端模块
--without-lua_resty_upload	不编译上传文件支持模块
--without-lua_resty_upstream_healthcheck	不编译基于 Lua 的服务器组健康监测模块
--without-lua_resty_string	不编译字符串实用程序和通用哈希函数的 Lua 库
--without-lua_resty_websocket	不编译基于 Lua 的非阻塞 WebSocket 服务/客户端
--without-lua_resty_limit_traffic	不编译 lua-resty-limit-traffic 支持库
--without-lua_resty_lock	不编译基于 Lua Nginx 模块的共享内存字典的简单非阻塞互斥锁 API
--without-lua_resty_lrucache	不编译 Lua-land LRU 缓存
--without-lua_resty_signal	不编译 lua-resty-signal 支持库，该支持库用于向 UNIX 进程发送信号
--without-lua_resty_shell	不编译 lua-resty-shell 支持库，该支持库可以实现通过 Lua 调用 shell 脚本的支持
--without-lua_resty_core	不编译使用 LuaJIT FFI 实现 Lua Nginx 模块提供的 Lua API
--with-luajit	编译 LuaJIT 2.1 解释器
--without-luajit-lua52	不编译基于 Lua 5.2 的 LuaJIT 扩展解释器

对于下表，有以下几点说明。

• 扩展的功能模块都是被默认编译的，可以通过参数设置选择不编译；
• DTrace 是基于系统底层的性能监控技术，可监测函数级别的内存、CPU 性能数据；
• Nginx 原有编译配置参数参见《Nginx编译安装》一节。

---

3、代码编译

OpenResty 代码编译如下所示:

yum -y install gcc pcre-devel make zlib-devel openssl-devel libxml2-devel \
    libxslt-devel gd-devel GeoIP-devel libatomic_ops-devel luajit \
    luajit-devel perl-devel perl-ExtUtils-Embed

./configure \
    --with-threads \
    --with-file-aio \
    --with-http_ssl_module \
    --with-http_v2_module \
    --with-http_realip_module \
    --with-http_addition_module \
    --with-http_xslt_module=dynamic \
    --with-http_image_filter_module=dynamic \
    --with-http_geoip_module=dynamic \
    --with-http_sub_module \
    --with-http_dav_module \
    --with-http_flv_module \
    --with-http_mp4_module \
    --with-http_gunzip_module \
    --with-http_gzip_static_module \
    --with-http_auth_request_module \
    --with-http_random_index_module \
    --with-http_secure_link_module \
    --with-http_degradation_module \
    --with-http_slice_module \
    --with-http_stub_status_module \
    --with-stream=dynamic \
    --with-stream_ssl_module \
    --with-stream_realip_module \
    --with-stream_geoip_module=dynamic \
    --with-stream_ssl_preread_module

gmake && gmake install

编译完成后，默认安装目录为 /usr/local/openresty。Nginx 安装在 /usr/local/openresty/nginx 目录下。

---

4、OpenResty集成的模块

在 OpenResty 中使用 Lua 是非常方便的，既可以在配置文件中通过 OpenResty 定义的指令区域直接编写 Lua 语法命令，也可以通过引用方式调用外部 Lua 脚本文件。

OpenResty 提供了很多非常实用的 Nginx 模块和 Lua 支持库，模块说明如下表所示。

模块文件夹名	模块说明
array-var-nginx-module	一个 Nginx 模块，向 Nginx 配置文件添加对数组类型变量的支持
drizzle-nginx-module	实现与 MySQL 或 Drizzle 数据库的代理连接支持
echo-nginx-module	该模块封装了大量 Nginx 内部 API，用于流式输入和输出、并行/顺序子请求、定时器和休眠，以及各种元数据访问
encrypted-session-nginx-module	该模块为基于 Mac 系统的 AES-256，为 Nginx 变量提供加密和解密支持
form-input-nginx-module	该模块读取编码为 application/x-www-form-urlencoded 的 HTTP POST 和 PUT 请求体，并将请求体中的参数解析为 Nginx 变量
headers-more-nginx-module	该模块允许用户添加、设置或清除指定响应或请求头
iconv-nginx-module	该模块使用 libiconv 转换不同编码的字符，它既可以处理 Nginx 变量，也可以作为输出过滤器处理响应体
lua-cjson	可为 Lua 提供快速的 JSON 解析和编码支持
lua-rds-parser	该 Lua 库可以用于将由 Drizzle Nginx 模块和 Postgres Nginx 模块生成的 Resty-DBD-Stream 流格式的数据解析为 Lua 数据结构
lua-redis-parser	该 Lua 库实现了一个精简而快速的将 Redis Raw 格式解析为 Lua 数据结构的解析器，同时还构造了一个 Redis Raw 格式请求函数
lua-resty-core	使用 LuaJIT FFI 实现的 Lua Nginx 模块 Lua API
lua-resty-dns	基于 Lua Nginx 模块 cosocket API 的非阻塞域名解析支持库
lua-resty-limit-traffic	用于限制和控制流量的 Lua 支持库
lua-resty-lock	该 Lua 库基于 Lua Nginx 模块的共享内存字典实现了一个简单的非阻塞互斥锁 API，主要用于消除 dog-pile effects
lua-resty-lrucache	Lua-land LRU 缓存支持库
lua-resty-memcached	基于 Lua Nginx 模块 cosocket API 的 Lua Memcached 客户端驱动支持库
lua-resty-mysql	基于 Lua Nginx 模块 cosocket API 的 Lua MySQL 客户端驱动支持库
lua-resty-redis	基于 Lua Nginx 模块 cosocket API 的 Lua Redis 客户端驱动支持库
lua-resty-shell	该支持库可以实现通过 Lua 调用 shell 脚本的支持
lua-resty-signal	该支持库用于向 UNIX 进程发送信号
lua-resty-string	为 Lua Nginx 模块提供字符串实用程序和公共哈希函数的 Lua 库
lua-resty-upload	基于 Lua Nginx 模块 cosocket API 的 HTTP 文件上传流式阅读器和解析器支持库
lua-resty-upstream-healthcheck	Nginx 上游服务器运行状况的主动检查支持库
lua-resty-websocket	基于 Lua Nginx 模块 cosocket API 的非阻塞 WebSocket 服务器和非阻塞 WebSocket 客户端支持库
lua-tablepool	基于 LuaJIT 的 Lua 表格资源回收池支持库
memc-nginx-module	该模块扩展了标准的 Memcached 模块，几乎支持全部 Memcached ASCII 协议，它允许用户为 Memcached 服务器定义一个 Rest 接口， 通过子请求或独立的伪请求在 Nginx 服务器中以非常高效的方式访问 Memcached 服务器
ngx_coolkit	该模块是一些小的、有用的 Nginx 附加组件集合
ngx_devel_kit	该模块旨在以其为基础为其他模块提供扩展 Nginx Web 服务器的核心功能支持
ngx_lua_upstream	该模块向 Lua Nginx 模块公开了一个 Lua API，用于 Nginx 上游服务器的操作
ngx_stream_lua	Nginx Stream 代理的 Lua 脚本支持模块
opm	OpenResty 的包管理工具
rds-csv-nginx-module	该 Lua 库可以用于将由 Drizzle Nginx 模块和 Postgres Nginx 模块生成的 Resty-DBD-Stream 流格式的数据解析为 CSV 数据结构
rds-json-nginx-module	该 Lua 库可以用于将由 Drizzle Nginx 模块生成的 Resty-DBD-Stream 流格式的数据解析为 JSON 数据结构
redis2-nginx-module	该模块使 Nginx 以非阻塞的方式与 Redis 2.x 服务器通信，已经完整地实现 Redis 2.0 协议支持，包括 Redis pipelining 支持
redis-nginx-module	该模块使 Nginx 以非阻塞的方式与 Redis 2.x 服务器通信，且与标准的 ngx_memcached 模块有相似的接口，但是只支持 Redis 的 GET 和 SELECT 命令
resty-cli	OpenResty 的命令行实用程序的集合
set-misc-nginx-module	该模块是 Nginx 的 rewrite 模块的功能增强模块，提供了更多的指令
srcache-nginx-module	该模块为 Nginx 提供了一个透明的缓存层，可以用在 Nginx 的任意位置
xss-nginx-module	该模块提供了跨站点 AJAX 支持，目前只支持跨站点的 GET 方法

各模块的详细功能和使用方法请参见官方网站的相关介绍。

---