nginx 通过 lua 模块在事件循环中嵌入轻量非阻塞逻辑，实现请求预处理、响应改写、外部服务协同等，无需新增进程；需启用 openresty 或编译 lua-nginx-module，配置 load_module 和 lua_package_path，并在 init_by_lua_block、access_by_lua_file 等钩子注入协程化异步逻辑。
直接在 Nginx 进程层面扩展功能，核心不是“扩进程”，而是借助 Lua 模块在 Nginx 的事件循环中嵌入轻量、非阻塞的逻辑，从而让单个 worker 进程承担更多动态任务——比如请求预处理、实时响应改写、外部服务协同（Redis/MySQL）、限流鉴权等。这比起新增进程或代理层更高效，也避免了上下文切换开销。
确认并启用 Lua 运行环境
宝塔面板默认 Nginx 不含 lua-nginx-module。必须先确保底层支持：
- 进入【软件商店】→ 查看已安装的 Nginx 类型：若为 OpenResty，则自带 LuaJIT 和模块，可跳过编译；若为标准 Nginx，则需卸载后安装 OpenResty 或手动编译添加
--add-module=.../lua-nginx-module及依赖ngx_devel_kit和LuaJIT - 执行
nginx -V 2>&1 | grep lua，确认输出含with-http_lua_module - 在【Nginx 配置】→【配置修改】的
http{}块顶部添加：load_module modules/ngx_http_lua_module.so;（OpenResty 路径通常有效）lua_package_path "/www/wwwroot/lua/?.lua;;";（指定脚本加载路径）
在关键处理阶段注入 Lua 逻辑
Nginx 请求生命周期有多个钩子，Lua 指令对应不同阶段，不干扰主流程，也不创建新进程：
-
init_by_lua_block：Master 进程加载配置时执行一次，适合预加载模块（如redis、cjson）、初始化全局连接池 -
access_by_lua_file：在权限校验阶段运行，可用于 IP 黑名单、UA 过滤、JWT 解析（不查库时），返回 403/401 直接终止 -
header_filter_by_lua_block：响应头已生成但未发送前，可动态加X-Processed-By、Cache-Control或根据 upstream 状态调整 Header -
log_by_lua_block：日志写入前执行，支持异步上报到 Kafka 或打点统计，不影响响应速度
用协程实现高并发外部协作
Lua 协程让 Nginx worker 能“看似同步”地调用外部服务，实际是非阻塞 I/O：
- 用
resty.redis连接 Redis 做毫秒级频控：local red = redis:new(); red:set_timeout(100); red:connect("127.0.0.1", 6379) - 用
ngx.location.capture发起内部子请求，例如调用本地 FastAPI 接口做风控决策，无需额外进程或反向代理配置 - 避免耗时操作：不使用
os.execute或同步 HTTP 库；所有网络调用必须走resty.*系列异步封装
调试与生产注意事项
高频 Lua 脚本需兼顾稳定性与可观测性：
- 开发期设
lua_code_cache off;（在http{}块），改脚本不用 reload；上线前务必设为on，否则性能骤降 - 用
ngx.log(ngx.WARN, "msg")记录关键路径，并配合lua_log_level warn;控制日志粒度 - 禁止在
set_by_lua*中做网络 I/O；它只适合快速计算（如解析 URI 参数、拼接字符串） - 脚本错误会导致整个 location 失效，建议用
pcall包裹关键逻辑，降级兜底
