nginx lua 调试 - 死磕

最新推荐文章于 2025-06-14 11:24:48 发布
最新推荐文章于 2025-06-14 11:24:48 发布
阅读量2.5k 收藏 3
点赞数 1
CC 4.0 BY-SA版权
分类专栏： java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/crazymakercircle/article/details/103747012
本文详细介绍如何使用ZeroBrane Studio进行Lua脚本的高效调试，包括环境搭建、配置及调试流程，适用于OpenResty/Nginx Lua脚本开发。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

疯狂创客圈 Java 高并发【 亿级流量聊天室实战】实战系列 【博客园总入口 】

架构师成长+面试必备之 高并发基础书籍 【Netty Zookeeper Redis 高并发实战 】

前言

Crazy-SpringCloud 微服务脚手架 &视频介绍：

Crazy-SpringCloud 微服务脚手架，是为 Java 微服务开发 入门者 准备的 学习和开发脚手架。并配有一系列的使用教程和视频，大致如下：

高并发 环境搭建 图文教程和演示视频，陆续上线：

中间件链接地址
Linux Redis 安装（带视频）Linux Redis 安装（带视频）
Linux Zookeeper 安装（带视频）Linux Zookeeper 安装, 带视频
Windows Redis 安装（带视频）Windows Redis 安装（带视频）
RabbitMQ 离线安装（带视频）RabbitMQ 离线安装（带视频）
ElasticSearch 安装, 带视频ElasticSearch 安装, 带视频
Nacos 安装（带视频）Nacos 安装（带视频）

疯狂创客圈 经典图书 ： 《Netty Zookeeper Redis 高并发实战》 面试必备 + 面试必备 + 面试必备

img
简介：
这里使用 Openresty 代替 nginx，使用基础nginx调试lua，方法也是一样的。

Openresty是基于nginx与lua的高性能web框架，继承了大量的高质量的lua库、第三方模块以及大多数依赖项。
目前对于lua主流开发工具有vscode+lua插件、IntelliJ IDEA+EmmyLua、ZeroBrane Studio、还有其他的一些文本编辑软件等。
lua作为一种脚本语言，除了开发简洁，性能优越之外，还应该具备调试功能，对于开发者才能算得上更加友好。

1 ZeroBrane 简介

ZeroBrane Studio已被用于调试各种Lua引擎 – 游戏框架（如Corona，Gideros，Moai，Love2d），家庭自动化设备，wirehark 脚本，Adobe Lightroom插件等 – 但是已经有几种Lua环境没有尝试过。其中一个是OpenResty / Nginx Lua脚本。OpenResty是一个基于nginx的网络应用服务器，一个非常快速的Web服务器，它提供了具有各种后端（Redis，Memcached，MySQL，HTTP服务器等）的非阻塞IO，并支持Lua作为其脚本语言。

ZeroBrane的特点：

  • 小巧，可移植，开源和跨平台（Windows，macOS和Linux）;

  • 自动完成功能，关键字和自定义API;

  • 110多种语言和文件格式的语法高亮和折叠;

  • 具有自动刷新功能的项目视图，能够从列表中隐藏文件和目录;

  • 交互式控制台，用于测试本地和远程执行的Lua代码片段;

  • 集成调试器，支持本地和远程调试，包括跨平台和设备上调试;

  • 使用Lua， LÖVE， Gideros， Moai， Corona，GSL-Shell和其他Lua引擎进行实时编码 ;

  • 多语言支持，翻译为法语，西班牙语，俄语，德语，中文，世界语，意大利语，保加利亚语和巴西葡萄牙语语言和文档，以添加您自己的语言;

  • 50+扩展包在包库 ;

  • 模糊搜索的文件，符号，和库函数，函数的轮廓，和更多。

    下载地址： https://studio.zerobrane.com/

​ 疯狂创客圈的网盘，也提供本实例配置的版本下载。 疯狂创客圈网盘入口
在这里插入图片描述

2 调试的环境介绍

包括以下三个方面：

  • openresty 的环境

  • project工程的环境

  • ZeroBrane Studio 的环境

  • lua 调试依赖包的配置

2.1 openresty 的环境

这里使用的是 openresty-1.13.6.2-win32 ,具体的安装和启动脚本，请参见 下面的博客：

windows openresty 死磕：安装和启动脚本

但是，一定要换成32位的版本。 然后，修改 openresty-start.bat 中对应的两个配置项。

修改完成后，使用openresty-start.bat 脚本，进行启动。
在这里插入图片描述

openresty-restart.bat 脚本，开发过程中会经常用到，因为每修改一次lua脚本，需要重新启动openresty/nginx ，重新进行加载。

2.2：lua project 工程的环境

大致按照下面的结构，组织 lua脚本的工程。 或者说nginx web项目的工程。
在这里插入图片描述

工程的目录，会在两个地方用到：

（1） openresty的 openresty-start.bat 脚本中

​ 具体请参见网盘的 openresty-start.bat 脚本 源码。

（2） 也会在 ZeroBrane Studio 的环境 用到

​ 会作为 ZeroBrane Studio 的工程目录。

2.3 ZeroBrane Studio 的工程目录

通过ZeroBrane Studio的file > new 菜单，打开 lua project 工程 所在的目录。
在这里插入图片描述

2.4 lua 调试依赖包的配置

将lua的依赖包路径，配置到 工程的 conf/nginx.conf 文件下：

（1） 项目的lua脚本路径

（2） ZeroBraneStudio-1.80 的lua脚本路径

（3） nginx的lua脚本路径

大致如下：

  # for windows
  lua_package_path "C:/dev/refer/LuaDemoProject/src/?.lua;E:/tool/ZeroBraneStudio-1.80/lualibs/?/?.lua;E:/tool/ZeroBraneStudio-1.80/lualibs/?.lua;E:/tool/openresty-1.13.6.2-win32/lualib/?.lua;;";
  
  lua_package_cpath "E:/tool/ZeroBraneStudio-1.80/bin/clibs/?.dll;E:/tool/openresty-1.13.6.2-win32/lualib/?.dll;;";

如果是linux环境，需 要进行相应的 路径，和文件类型的修改。上面的dll，在liux环境，需要改成so。

2.5 准备调试脚本

调试的脚本为：luaScript/test.lua

--- 启动调试

local mobdebug = require("luaScript.initial.mobdebug");
mobdebug.start("192.168.0.5");

ngx.say("hello world.");
ngx.say("<hr>");
ngx.say(package.path);

local i=100;
ngx.say("<hr>");
ngx.say("i="..i);

mobdebug.done();

在conf/nginx.conf 文件, 配置好 luaScript/test.lua 对应的路径：

location /test {  
default_type 'text/html';  
charset utf-8; 
content_by_lua_file luaScript/test.lua;
}

3 开始调试 lua

3.1 启动调试的服务器

启动ZeroBrane Studio（zbstudio.exe或zbstudio.sh）并启动调试服务器 ，菜单为 Project | Start Debugger Server。

在这里插入图片描述

3.2 启动调试的服务器

在浏览器输入lua脚本所配置的地址，如果： http://localhost/test

location /test {  
default_type 'text/html';  
charset utf-8; 
content_by_lua_file luaScript/test.lua;
}

ZeroBrane Studio会进入绿色箭头对应行的代码

3.3 查看运行时的变量值

使用watch工具，将需要查看的变量， 填入。 然后开始单步执行。 具体如下图

在这里插入图片描述

3.4 调试后的结果

程序调试完成后，可以在浏览器看到预期的结果。
在这里插入图片描述

3.5 调试快捷键

  • F10 下一行
  • Shift+F10 跳过调试
  • Ctrl +F10 跳过当前function
  • Shift + F5 终止运行
  • F6 运行
  • F5 debug运行

3.6 问题 :module socket.core 加载失败

如果出现以下问题：

2019/12/28 17:09:57 [error] 14568#13196: *1 lua entry thread aborted: runtime error: error loading module 'socket.core' from file 'E:/tool/ZeroBraneStudio-1.80/bin/clibs/socket\core.dll'

用一种可能就是使用了的64位的OpenResty，换成32位的OpenResty 即可。

疯狂创客圈的网盘，本文所涉及有的工具的安装文件，都有提供。

具体，请关注 Java 高并发研习社群 【博客园 总入口 】

最后，介绍一下疯狂创客圈：疯狂创客圈，一个Java 高并发研习社群 【博客园 总入口 】

疯狂创客圈，倾力推出：面试必备 + 面试必备 + 面试必备 的基础原理+实战 书籍 《Netty Zookeeper Redis 高并发实战》

img

疯狂创客圈 Java 死磕系列

  • Java (Netty) 聊天程序【 亿级流量】实战 开源项目实战

  • Netty 源码、原理、JAVA NIO 原理

  • Java 面试题 一网打尽

  • 疯狂创客圈 【 博客园 总入口 】
    R0cHM6Ly9pbWcyMDE4LmNuYmxvZ3MuY29tL2Jsb2cvMTQ4NTM5OC8yMDE5MDgvMTQ4NTM5OC0yMDE5MDgyMjIyNTE1NjQyNy05NTY0MjQxMjQuanBn?x-oss-process=image/format,png)

nginx lua 调试bug
阳光梦的专栏
08-10 2959
前提：     lua中开启bug；     daemon off;     master_process off;     worker_rlimit_core 500M;      working_directory /opt/WiseGrid/smartl7/sbin;     error_log    /var/log/smartl7/smartl7.log debug_http;    ...
lua配合nginx进行代码(nginx配置文件)调试
weixin_34185512的博客
11-07 1888
nginx有echo模块可以实现输出字符串到web浏览器上，实现方式如下： 首先要nginx支持echo模块，然后在修改配置文件进行测试。 下载模块： 下载路径：https://github.com/openresty/echo-nginx-module/tags 重新编译nginx： 编译之前用nginx -v查看原先编译代码，然后...
深入了解luadebug插件：Lua脚本调试工具的精髓
最新发布
weixin_42515392的博客
06-14 641
在软件开发过程中，调试是确保代码质量的关键步骤。随着开发环境的复杂化，简单的控制台输出已无法满足开发人员对高效调试的需求。Lua是一种轻量级的脚本语言，广泛应用于游戏开发、嵌入式系统等领域。为了提升Lua脚本开发的效率，luadebug插件应运而生。它提供了一系列强大的调试工具，使得开发人员可以深入分析代码，快速定位和修复bug。Lua是一门轻量级的脚本语言，最早由巴西里约热内卢天主教大学在1993年开发。由于其简洁的设计和强大的功能，Lua很快在嵌入式应用、游戏开发、网络编程等领域得到广泛应用。
ngnix lua
lydstory123的专栏
09-26 165
从事高性能web服务器和反向代理、高防ip、waf相关开发和维护；熟悉linux 操作系统; 熟悉c语言或lua 语言; 熟悉nginx 模块和原理，能结合ngx_lua模块来进行相关业务开发; 有nginx/openresty 开发经验及性能调优优先; 有生产环境下高并发开发经验优先; ...
Nginx实战：LUA脚本_环境配置安装
龙叔运维的博客
06-01 4019
Nginx Lua 脚本是 Nginx 与 Lua 语言集成的结果，它允许你使用 Lua 语言编写Nginx 模块，以执行复杂的逻辑、访问后端服务、处理请求和响应等。
Nginx添加Lua模块和优化配置
budongfengqing的博客
06-15 6763
Nginx添加Lua模块和优化配置 文章目录Nginx添加Lua模块和优化配置参考文档：一、引子二、安装LuaJIT22.1、关于 LuaJIT 和 Openresty的luajit22.2、安装2.3、环境变量配置三、Nginx Module下载3.1、ngx_devel_kit3.2、lua-nginx-module四、Nginx编译配置和测试4.1、nginx编译安装4.2、配置nginx4.3、启动nginx并测试五、Nginx在reponse返回的cookie中设置HttpOnly5.1、编写脚本
简历上写精通Nginx/OpenResty详解，Nginx的核心原理应该不过分吧
m0_63437643的博客
01-14 686
Nginx的核心原理 本节为大家介绍Nginx的核心原理，包含Reactor模型、Nginx的模块化设计、Nginx的请求处理阶段。 虽然本节的知识有一定的理论深度，但是与另一个有名的Java底层通信框架Netty在原理上有很多相似的地方。如果大家了解Netty的原理和Reactor模式，阅读本节将会更加轻松和愉快。 Reactor模型 Nginx对高并发IO的处理使用了Reactor事件驱动模型。Reactor模型的基本组件包含事件收集器、事件发送器、事件处理器3个基本单元，其核心思想是将所有要.
详解Nginx的核心原理
l688899886的博客
08-18 1453
本节为大家介绍Nginx的核心原理，包含Reactor模型、Nginx的模块化设计、Nginx的请求处理阶段。虽然本节的知识有一定的理论深度，但是与另一个有名的Java底层通信框架Netty在原理上有很多相似的地方。如果大家了解Netty的原理和Reactor模式，阅读本节将会更加轻松和愉快。...
Nginx+Lua（OpenResty）搭建以及成果测试（3）！
歌者的博客
08-02 265
——这次分享一下模拟带Body的POST请求，然后利用Lua脚本解析参数数据。 1、curl 模拟POST命令 curl http://localhost/luatest -H "Content-Type:application/json" -d '{"user":"me","id":"5"}' # -H "Content-Type:application/json" 大概意思就是以jso...
nginx配置lua脚本
一杯米酒
01-27 5445
nginx+lua
nginx + lua环境搭建
走马行酒醴，驱车布鱼肉
08-23 4105
Lua 是一个小巧的脚本语言。该语言的设计目的是为了嵌入应用程序中，从而为应用程序提供灵活的扩展和定制功能。 Lua脚本可以很容易的被C/C++代码调用，也可以反过来调用C/C++的函数，这使得Lua在应用程序中可以被广泛应用。 不仅仅作为扩展脚本，也可以作为普通的配置文件，代替XML,Ini等文件格式，并且更容易理解和维护。 直接使用官方的nginx + lua_nginx_m
Nginx Lua 开发 - MongoDB 独立模块的安装
潘广宇的博客
03-29 932
Nginx 使用 lua-resty-mongol 模块访问 MongoDB，但该包并没打包在 Openresty 中，需要单独安装。 一、安装 lua-resty-mongol 模块地址：https://github.com/bigplum/lua-resty-mongol git clone https://github.com/bigplum/lua-resty-mongol cd...
Lua脚本本地调试
A1L__的博客
07-14 2112
这里主要使用日志的方式进行debug。
记录一次nginx+lua
qq_41793222的博客
06-07 280
[root@eshop-cache01 ~]# cd /usr/hello/[root@eshop-cache01 hello]# lltotal 16-rw-r--r--. 1 root root  291 Apr 26 18:18 hello.confdrwxr-xr-x. 2 root root 4096 Jun  6 00:07 luadrwxr-xr-x. 6 root root 409...
nginx整合lua脚本开发入门
handsomestWei的博客
12-22 948
nginx整合lua脚本开发入门。包括脚本调试，日志排查等
nginx如何结合lua的？
阳光梦的专栏
10-18 3168
什么是OpenResty？         将Lua和Nginx粘合ngx_lua模块，并且将Nginx核心、LuaJIT、ngx_lua模块、许多有用的Lua库和常用的第三方Nginx模块组合而成。什么是ngx_lua及原理？         ngx_lua是Nginx的一个模块，将Lua嵌入到Nginx中，从而可以使用Lua来编写脚本，这样就可以使用Lua编写应用脚本，部署到Nginx中运...
Nginx与LUA（5）
分享专业、有用、有趣的技术、产品、运营和管理知识。
01-20 2021
Nginx又是业务直接和外部交流的接入点，对二次开发和动态变化又有着强烈的以及一些定制化的需求，因此出现了LUA这种嵌入式的脚本语言，它能揉和以及处理各种不同的Nginx上游输出（proxy、log等）。
终于靠这篇文章学透了Nginx/OpenResty详解，NginxLua编程
公众号：该用户快成仙了
08-24 851
Nginx Lua编程 经过合理配置，Nginx毫无疑问是高性能Web服务器很好的选择。 除此之外，Nginx还具备可编程能力，理论上可以使用Nginx的扩展组件ngx_lua开发各种复杂的动态应用。不过，由于Lua是一种脚本动态语言，因此不太适合做复杂业务逻辑的程序开发。但是，在高并发场景下，Nginx Lua编程是解决性能问题的利器。 Nginx Lua编程的主要应用场景 Nginx Lua编程主要的应用场景如下： （1）API网关：实现数据校验前置、请求过滤、API请求聚合、AB测试、灰度发
基于Nginx和Lua的结合防CC-尚文网络xUP楠哥
weixin_42081313的博客
09-02 375
#实战描述： CC攻击的原理就是攻击者控制某些主机不停地发大量数据包给对方服务器造成服务器资源耗尽，一直到宕机崩溃。CC主要是用来攻击页面的，每个人都有这样的体验：当一个网页访问的人数特别多的时候，打开网页就慢了，CC就是模拟多个用户（多少线程就是多少用户）不停地进行访问那些需要大量数据操作（就是需要大量CPU时间）的页面，造成服务器资源的浪费，CPU长时间处于100%，永远都有处理不完的连接直至就网络拥塞，正常的访问被中止。 OpenResty又被称为ngx_openresty，是基于Nginx的核心W.
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值