宝塔面板需通过OpenResty或手动编译启用Lua模块，配置load_module与lua_package_path，再用access_by_lua_file或header_filter_by_lua_block嵌入脚本实现请求拦截与响应头修改，并通过lua_log_level和log_by_lua_block调试。
如果您已熟悉宝塔面板的基本操作，并希望进一步利用Nginx的可扩展性增强Web服务能力，则可通过OpenResty集成的Lua模块，在Nginx配置中嵌入Lua脚本实现定制化逻辑。以下是具体实施步骤：
一、确认Nginx支持Lua模块
宝塔默认安装的Nginx不包含lua-nginx-module，需使用OpenResty或手动编译添加支持。此步骤用于验证当前环境是否具备执行Lua脚本的前提条件。
1、登录宝塔面板，进入【软件商店】→【已安装】，查找已安装的Nginx版本名称。
2、在SSH中执行命令：nginx -V 2>&1 | grep -o with-http_lua_module，若返回结果为空，则表示未启用Lua模块。
3、如未启用，可卸载当前Nginx，改用宝塔插件市场中的【OpenResty】（支持Lua内置）或通过【编译安装】方式添加lua-nginx-module参数重新构建。
二、启用Nginx配置中的Lua指令权限
Lua脚本需通过特定指令注入Nginx处理流程，而宝塔默认禁用部分高危指令。此步骤确保server块与location块中可合法使用lua_*系列指令。
1、进入【网站】→【对应站点】→【配置文件】，定位到server段落。
2、在server块顶部添加：load_module modules/ngx_http_lua_module.so;（仅OpenResty或手动编译含该模块时有效）。
3、在http块（可通过【Nginx配置】→【配置修改】访问）中添加：lua_package_path "/www/wwwroot/lua/?.lua;;";，指定Lua脚本搜索路径。
三、编写并调用独立Lua脚本实现请求拦截
将业务逻辑分离至外部.lua文件，便于维护与复用，适用于IP限频、UA过滤等场景。
1、在/www/wwwroot/目录下新建lua子目录：mkdir -p /www/wwwroot/lua。
2、创建过滤脚本：/www/wwwroot/lua/block_bot.lua，内容为：if ngx.var.http_user_agent and string.find(ngx.var.http_user_agent, "Baiduspider") then ngx.exit(403) end。
3、在站点配置文件的location / {}块内添加：access_by_lua_file /www/wwwroot/lua/block_bot.lua;。
四、使用inline Lua代码动态修改响应头
对于轻量级逻辑，可直接在Nginx配置中嵌入Lua代码，避免文件I/O开销，适用于Header注入、时间戳标记等即时操作。
1、在站点配置文件的location ~ \.php$ {}块末尾插入：header_filter_by_lua_block { ngx.header.X-Processed-Time = ngx.now() }。
2、保存配置后点击【重载配置】，访问PHP资源时检查响应头是否包含X-Processed-Time字段。
3、如需基于状态码条件触发，可改用：body_filter_by_lua_block { if ngx.status == 200 then ngx.ctx.foo = "bar" end }。
五、调试Lua脚本错误与日志输出
Lua运行错误不会直接显示在浏览器中，必须依赖Nginx错误日志定位问题，此步骤确保异常可追溯。
1、在Nginx主配置（/www/server/nginx/conf/nginx.conf）的http块中添加：lua_log_level warn;。
2、在需要调试的location中加入：log_by_lua_block { ngx.log(ngx.WARN, "URI:", ngx.var.uri, " UA:", ngx.var.http_user_agent) }。
3、执行tail -f /www/wwwlogs/nginx_error.log实时查看Lua警告与错误信息。
