Nginx 如何集成 Lua 或其他语言插件

Nginx 虽然以高性能和模块化著称，但它本身并不具备处理复杂逻辑或动态内容的能力。为了增强 Nginx 的可编程性，我们可以通过集成 Lua 脚本或其他语言插件，让 Nginx 拥有“业务逻辑大脑”。

本文将以 Lua 为核心，介绍如何在 Nginx 中集成编程能力，并扩展到其他语言插件的接入方式。

目录

• 一、为什么需要在 Nginx 中编程
• 二、常用的扩展方式概览
• 三、使用 Lua 插件的推荐方式：OpenResty
• 四、Lua 常见用法示例
• 五、Nginx 支持其他语言的方式
• 六、使用注意事项
• 总结

一、为什么需要在 Nginx 中编程

默认情况下，Nginx 的行为由配置文件决定，缺乏“逻辑判断能力”，这在以下场景中有明显限制：

• 根据请求内容动态转发或处理
• 实现接口级别的灰度发布、A/B 测试
• 实时访问控制（如防刷、限流规则）
• 高性能缓存控制与签名校验
• 自定义认证逻辑或数据过滤

通过嵌入脚本语言，我们可以灵活地扩展 Nginx 的功能，使其更适合业务型中间层或边缘计算场景。

二、常用的扩展方式概览

在 Nginx 中集成脚本或其他语言，常见方式如下：

1. Lua（最主流）
   使用 ngx_http_lua_module 或 OpenResty 集成，性能高、社区成熟。

2. Python / Go / Node.js
   不能嵌入 Nginx 内部，但可以通过 Nginx 转发到本地服务或 FastCGI 网关间接集成。

3. C/C++ 模块扩展
   原生模块方式开发，性能最强，但开发成本高，调试困难。

其中，Lua 是唯一可以与 Nginx 原生融合的脚本语言。

三、使用 Lua 插件的推荐方式：OpenResty

OpenResty 是基于 Nginx 打包的 Web 平台，内置了 LuaJIT 和一系列 Nginx 模块，可让你在配置文件中直接书写 Lua 脚本。

安装方式（以 Ubuntu 为例）：

sudo apt install openresty

配置示例：

server {
    listen 8080;

    location /hello {
        default_type text/plain;
        content_by_lua_block {
            ngx.say("Hello from Lua inside Nginx!")
        }
    }
}

启动：

sudo openresty -p `pwd` -c nginx.conf

也可以使用普通 Nginx + Lua 模块的方式编译：

./configure --with-http_lua_module
make && make install

但不建议自行编译，OpenResty 更推荐且更稳定。

四、Lua 常见用法示例

以下是一些常见的 Lua 插件用法：

请求重写逻辑

rewrite_by_lua_block {
    if ngx.var.arg_token ~= "123456" then
        return ngx.exit(403)
    end
}

动态转发

set_by_lua_block $backend {
    if ngx.var.arg_user == "vip" then
        return "backend1"
    else
        return "backend2"
    end
}

proxy_pass http://$backend;

自定义访问日志

log_by_lua_block {
    ngx.log(ngx.ERR, "Request to ", ngx.var.request_uri)
}

使用 Redis、MySQL 等

OpenResty 提供了很多第三方 Lua 库，例如：

local redis = require "resty.redis"
local red = redis:new()
red:set_timeout(1000)
red:connect("127.0.0.1", 6379)
red:set("key", "value")

只需使用 Lua 编写逻辑，就能在请求链路中读写外部服务。

五、Nginx 支持其他语言的方式

虽然 Nginx 只能原生集成 Lua，但可以借助以下方式集成其他语言：

反向代理到本地服务

通过 proxy_pass 将请求转发到 Node.js、Go、Python 等语言编写的服务：

location /ml-api/ {
    proxy_pass http://127.0.0.1:9000;
}

适合做机器学习服务、配置服务、数据服务等。

FastCGI 模式（如 PHP）

通过 fastcgi_pass 连接 PHP-FPM、Python-FCGI 等后端：

location ~ \.php$ {
    fastcgi_pass 127.0.0.1:9000;
    include fastcgi_params;
}

使用 uwsgi 或 scgi 模块

适用于 Python 的 Flask/Django 应用，可通过 uwsgi_pass 与 Nginx 集成。

这些方式都是“语言服务 + Nginx 反向代理”组合，适用于业务系统，不适用于高性能中间件层。

六、使用注意事项

• Lua 代码运行在 Nginx 的 worker 进程中，必须避免阻塞式 I/O
• 推荐使用 OpenResty，避免手动编译和模块兼容问题
• Lua 脚本尽量精简，复杂逻辑应下放至后端服务
• 调试 Lua 脚本推荐打开 error 日志或使用 ngx.log
• 所有动态变量必须由 $ 开头或用 ngx.var

总结

在 Nginx 中集成 Lua 是一种非常灵活的方式，可以在不改动后端服务的前提下，完成复杂的请求处理逻辑。配合 OpenResty，你可以将 Nginx 变成一个具备轻量编程能力的“边缘网关”，广泛应用于 A/B 实验、限流、动态路由、安全校验等场景。