Linux下Nginx源码编译安装Lua模块开放resty-Nginx-PHP中文网

需源码编译集成lua-nginx-module：先装LuaJIT并验证，再configure指定模块路径和头文件/库路径，make安装后通过content_by_lua_block验证。

linux下nginx源码编译安装lua模块开放resty

在 Linux 下通过源码编译 Nginx 并集成 OpenResty 的 Lua 模块（即 lua-nginx-module），核心是让 Nginx 支持嵌入 Lua 脚本，实现高性能、可编程的 Web 服务逻辑。这不是简单加个动态模块，而是需要在编译阶段将 Lua 支持“ baked in”。OpenResty 提供了完整打包的方案，但若你坚持从头编译原生 Nginx + 官方 lua-nginx-module，以下步骤清晰可行。

准备依赖和基础环境

确保系统已安装编译工具链及必要库：

gcc、make、perl、libpcre3-dev（或 pcre-devel）、zlib1g-dev（或 zlib-devel）、openssl-dev（或 openssl-devel）
Lua 解释器：推荐使用 Lua 5.1 或 LuaJIT（OpenResty 默认用 LuaJIT，性能更好；若选 Lua 5.1，需确保 lua5.1 及 liblua5.1-dev 已安装）
下载 Nginx 源码（如 nginx-1.24.0）、lua-nginx-module（如 v0.10.25）、LuaJIT（如 v2.1-20230320）或 lua5.1 源码

编译并安装 LuaJIT（推荐）

OpenResty 和大多数生产场景倾向 LuaJIT —— 它比标准 Lua 快数倍，且与 nginx-module 兼容性好：

解压 LuaJIT 源码，进入目录执行：make && sudo make install
默认安装到 /usr/local，头文件在 /usr/local/include/luajit-2.1，库文件在 /usr/local/lib/libluajit-5.1.a
确认可用：luajit -v 应输出版本号

配置并编译 Nginx（含 lua-nginx-module）

关键在于 ./configure 阶段正确指定 LuaJIT 路径和模块位置：

假设 lua-nginx-module 解压在 ~/src/lua-nginx-module-0.10.25，LuaJIT 安装在 /usr/local
执行 configure（精简常用选项）：

./configure \
--prefix=/usr/local/nginx \
--with-http_ssl_module \
--with-http_realip_module \
--with-http_v2_module \
--add-module=~/src/lua-nginx-module-0.10.25 \
--with-ld-opt="-Wl,-rpath,/usr/local/lib" \
--with-cc-opt="-I/usr/local/include/luajit-2.1"

--add-module 指向 lua-nginx-module 源码目录（不是 .so 文件）
--with-cc-opt 告诉编译器 LuaJIT 头文件位置
--with-ld-opt 确保运行时能定位 libluajit（尤其避免 “cannot open shared object file: libluajit-5.1.so.2” 错误）
接着运行：make && sudo make install

验证 Lua 模块是否生效

编辑 /usr/local/nginx/conf/nginx.conf，在 http 块中添加最小测试配置：

lua_package_path "/path/to/your/lua/?.lua;;";
server {
    listen 8080;
    location /hello {
        content_by_lua_block {
            ngx.say("Hello from Lua in Nginx!")
        }
    }
}

保存后执行：/usr/local/nginx/sbin/nginx -t 检查语法
启动：/usr/local/nginx/sbin/nginx
访问 curl http://localhost:8080/hello，应返回对应字符串
若报错 “unknown directive 'content_by_lua_block'”，说明模块未正确编译进 Nginx，重点检查 configure 参数和路径是否拼写准确

不复杂但容易忽略：Nginx 不支持运行时加载 lua-nginx-module，必须源码编译集成；LuaJIT 路径、RPATH 设置、模块路径三者任一出错都会导致失败。稳住节奏，逐项验证，就能跑通。