Lua :: NJET文档

Openresty新增特性

Thu, 21 Aug 2025 10:11:51 +0800

1. 功能描述增加 lua_ssl_certificate和lua_ssl_certificate_key这两个命令,目前支持rsa和ecc 证书对resolver指令的增强,增加了local配置参数, local=on 和 local=path的情况 2. 配置说明 2.1 证书配置: http { include mime.types; lua_package_path "/home/njet/test_pcre2/work/usr/local/njet/lualib/lib/?.lua;$prefix/scripts/?.lua;;"; server { server_name aaaa; listen 8002 ssl; #rsa 和国密证书使用 # ssl_ciphers "ECC-SM2-SM4-CBC-SM3:ECDHE-SM2-WITH-SM4-SM3:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-SHA:AES128-GCM-SHA256:AES128-SHA256:AES128-SHA:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:AES256-GCM-SHA384:AES256-SHA256:AES256-SHA:ECDHE-RSA-AES128-SHA256:!aNULL:!eNULL:!RC4:!EXPORT:!DES:!3DES:!MD5:!DSS:!PKS"; ssl_ntls on; #ecc 证书使用 ssl_ciphers 'EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH'; server_tokens off; ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3; ssl_verify_client off; lua_ssl_certificate /home/njet/test_pcre2/ecc.limin.crt.pem ; lua_ssl_certificate_key /home/njet/test_pcre2/ecc.limin.key.pem; ssl_certificate /home/njet/test_pcre2/ecc.limin.crt.pem; ssl_certificate_key /home/njet/test_pcre2/ecc.limin.key.pem; location /test { content_by_lua_block { local m, err = njt.re.match("hello, 1234", "[0-9]+") if m then njt.say("match found") else njt.say("match not found") end } } location /lua { content_by_lua 'njt.say("hello,lua")'; } location /lua1 { content_by_lua_block { local m, err = njt.re.match("http://www.tinywan.com/live", "(?<=://)[A-Za-z0-9.]+(?=/)") if m then -- m[0] == "1234" njt.say(m[0]) njt.say(m[1]) else if err then njt.log(ngx.ERR, "error: ", err) return end njt.say("match not found") end njt.say('finished') } } } } 2.2 resolver 配置 local=on会去加载/etc/resolv.conf local=path 加载指定位置

动态lua

Thu, 21 Aug 2025 10:11:46 +0800

1. 功能描述该模块允许通过 /api/v1/config/http_lua 动态配置接口, 动态设置 content_by_lua_block 及 access_by_lua_block的内容。同时配置access_by和content_by时，优先触发access_by内容。 2. 依赖模块动态lua功能依赖模块： load_module /usr/local/njet/modules/njt_http_lua_module.so; load_module /usr/local/njet/modules/njt_http_dyn_lua_module.so; 特殊说明：njt_http_lua_module.so要在njt_http_lua_module.so上面。 3. 配置说明 njet.conf load_module /usr/local/njet/modules/njt_http_lua_module.so; load_module /usr/local/njet/modules/njt_http_dyn_lua_module.so; http { ... server { lua_package_path "$prefix/lualib/lib/?.lua;/usr/local/njet/modules/?.lua;;"; lua_package_cpath "$prefix/lualib/clib/?.so;;"; ... } } 4. 调用样例 4.1 API说明查询接口： GET http://IP+port/api/v1/config/http_lua 修改接口： PUT http://IP+port/api/v1/config/http_lua 4.2 通过PUT接口添加动态lua curl -X PUT http://127.0.0.1:8081/api/v1/config/http_lua -d' { "servers": [ { "listens": [ "0.0.0.0:8080" ], "serverNames": [ "localhost" ], "locations": [ { "location": "/", "lua": {} }, { "location": "/test_lua", "lua": { "content_by": "njt.say(\"lua new test str\");", "access_by": "njt.exit(njt.HTTP_FORBIDDEN);" } } ] } ] } 4.3 通过GET接口查看动态lua curl -X GET http://127.0.0.1:8081/api/v1/config/http_lua { "servers": [ { "listens": [ "0.0.0.0:8080" ], "serverNames": [ "localhost" ], "locations": [ { "location": "/", "lua": {} }, { "location": "/test_lua", "lua": { "content_by": "njt.say(\"lua new test str\");", "access_by": "njt.exit(njt.HTTP_FORBIDDEN);" } } ] } ] }

Http模块lua深层清理

Tue, 21 Oct 2025 17:31:32 +0800

1. 功能描述 NJet 集成了Lua 的运行环境，在不配置 lua_code_cache off; 的情况下，worker收到请求时，会从context中获取已经创建的Lua VM (第一次执行Lua相关代码时创建）。Lua VM中, package.loaded 是一个核心的 Lua 表，它扮演着 Lua 模块缓存的角色。当使用 require(“module_name”) 加载一个 Lua 模块时，Lua 解释器会首先检查 package.loaded 表中是否已经存在名为 module_name 的模块。如果存在，它会直接返回已缓存的模块值；如果不存在，它才会去文件系统（根据 package.path）查找、加载并执行该模块文件，然后将其返回值存储到 package.loaded 中，供后续调用。在配置了多个 worker 进程时，每个worker 进程都拥有自己独立的 LuaJIT 虚拟机实例 (Lua State)。这意味着每个 worker 进程的 Lua 虚拟机都有自己独立的 package.loaded 表，它们之间互不影响。有可能造成部分worker进程缓存了模块，部分进程没有对模块进行缓存。当更新了磁盘上的 Lua 模块文件时，例如 mylib.lua, package.loaded 中已经缓存了旧版本的 mylib的worker进程将执行旧版的代码，而未缓存该模块的部分worker进程收到请求时将直接使用新版本，这样照成了各个worker的行为不一致。并且那些被间接 require 的模块（即主 Lua 脚本 require 了 A，而 A 又 require 了 B），Lua 自身也没有机制去追踪这种深层次的依赖关系并自动刷新。 2. 依赖模块 http模块lua深层清理依赖于http动态lua功能： load_module modules/njt_http_lua_module.so; load_module modules/njt_http_dyn_lua_module.so; 3. API说明清理接口：