OpenResty 1.31.1.1 正式发布

lijunlong , 13 May 2026 (created 13 May 2026)

我们荣幸地宣布，基于 NGINX 和 LuaJIT 的 OpenResty Web 平台 1.31.1.1 版本现已正式发布。

点击此处下载。

此下载页面提供了可移植的源代码分发包，以及为 Ubuntu、Debian、Fedora、CentOS、RHEL、OpenSUSE、Amazon Linux 等系统预编译的二进制软件包。

版本亮点

Nginx 核心
- 从 nginx 1.29.2 升级至 1.31.1。
OpenSSL
- 从 3.5.5 版本升级至 3.5.6 版本。
升级 lua-nginx-module 至 v0.10.31
- 新功能：新增 FFI 函数 ngx_http_lua_ffi_socket_tcp_get_ssl_pointer() 和 ngx_http_lua_ffi_socket_tcp_get_ssl_ctx()。感谢 lijunlong 提供补丁。
- 新功能：新增 API tcpsock:getsslsession。感谢 lijunlong 提供补丁。
- 新功能：新增 ngx_http_lua_ffi_get_upstream_ssl_pointer。感谢 lijunlong 提供补丁。
- 新功能：新增 precontent_by_lua 指令。感谢 Hanada 提供补丁。
- 新功能：新增获取服务器随机数和主密钥的 API。感谢 xiangwei 提供补丁。
- 新功能：为 TCP 套接字新增 keepintvl 和 keepcnt 选项。感谢 lijunlong 提供补丁。
- 新功能：新增 proxy_ssl_verify_by_lua* 指令。感谢 willmafh 提供补丁。
- 新功能：支持 cosocket TLS 握手时使用自定义的可信 CA 存储。(#2495) 感谢 Walker Zhao 提供补丁。
- 缺陷修复：在 nginx -T 中新增配置转储支持。感谢 Y.Horie 提供补丁。
- 缺陷修复：在 ngx_http_lua_pipe_proc_wait_cleanup 中清除等待定时器，以防止 QUIC 连接关闭时的 SIGSEGV 错误。感谢 Jun Ouyang 提供补丁。
- 缺陷修复：修复 freenginx 的兼容性问题。感谢 Y.Horie 提供补丁。
- 缺陷修复：修复 config 中的拼写错误。感谢 xuruidong 提供补丁。
- 缺陷修复：通过确保设置 old_cycle 来防止 SSL 缓存中的空指针解引用。感谢 Jun Ouyang 提供补丁。
- 缺陷修复：防止 worker 关闭期间事件定时器红黑树中的 SIGSEGV 错误。感谢 Gabriel Clima 提供补丁。
- 缺陷修复：在 QUIC 连接关闭路径中，确保连接在连接池销毁之前关闭，以防止 ngx_http_lua_pipe 中的 use-after-free 崩溃。感谢 Jun Ouyang 提供补丁。
- 缺陷修复：在删除协程引用之前进行检查，以防止 uthread 崩溃。感谢 Jun Ouyang 提供补丁。
- 变更：允许 ngx.header['WWW-Authenticate'] 使用 table 设置多个值。感谢 BotoX 提供补丁。
- 优化：新增对 freenginx 的兼容性支持。感谢 Sergey A. Osokin 提供补丁。
- 优化：在 cosocket 的错误日志中添加上游服务器信息。感谢 lijunlong 提供补丁。
升级 stream-lua-nginx-module 至 v0.0.19
- 新功能：新增 FFI API ngx_stream_lua_ffi_socket_tcp_getfd。感谢 lijunlong 提供补丁。
- 新功能：新增 FFI 函数 ngx_stream_lua_ffi_socket_tcp_get_ssl_pointer() 和 ngx_stream_lua_ffi_socket_tcp_get_ssl_ctx()。感谢 lijunlong 提供补丁。
- 新功能：新增 API tcpsock:get_ssl_session。感谢 lijunlong 提供补丁。
- 新功能：新增 ngx_stream_lua_ffi_get_upstream_ssl_pointer。感谢 lijunlong 提供补丁。
- 新功能：为 UDP cosocket 绑定本地端口新增 reuseport 支持。感谢 lijunlong 提供补丁。
- 新功能：为 TCP 套接字新增 keepintvl 和 keepcnt 选项。感谢 lijunlong 提供补丁。
- 新功能：在下游套接字上实现 serversslhandshake 方法 (#392)。感谢 Rob Mueller 提供补丁。
- 新功能：新增 proxy_ssl_certificate_by_lua 指令。感谢 willmafh 提供补丁。
- 新功能：支持 cosocket TLS 握手时使用自定义的可信 CA 存储。(#401) 感谢 Walker Zhao 提供补丁。
- 优化：在 cosocket 的错误日志中添加上游服务器信息。感谢 lijunlong 提供补丁。
- 缺陷修复：修复当 nginx 关闭定时器触发时未关闭 cosocket 的问题。感谢 lijunlong 提供补丁。
- 缺陷修复：在删除协程引用之前进行检查，以防止 uthread 崩溃。感谢 Jun Ouyang 提供补丁。
升级 lua-resty-core 至 v0.1.34rc2
- 新功能：新增获取服务器随机数和主密钥的 Lua API。感谢 mengxiangwei 提供补丁。
- 新功能：新增 API tcpsock:getsslsession。感谢 lijunlong 提供补丁。
- 新功能：新增 precontent_by_lua 指令。感谢 Hanada 提供补丁。
- 新功能：为 TCP 套接字新增 keepintvl 和 keepcnt 选项。感谢 lijunlong 提供补丁。
- 新功能：新增 sock:getsslpointer() 和 sock:getsslctx()。感谢 lijunlong 提供补丁。
- 新功能：新增 ssl.get_upstream_ssl_pointer。感谢 lijunlong 提供补丁。
- 新功能：为 stream 子系统新增 tcpsock.getfd()。感谢 lijunlong 提供补丁。
- 新功能：新增 tcpsock:settrustedstore()，支持为每次握手设置可信 CA。感谢 Walker Zhao 提供补丁。
- 新功能：新增 proxy_ssl_certificate_by_lua 指令。感谢 willmafh 提供补丁。
- 新功能：为 stream 子系统支持 tcpsock:settrustedstore()。感谢 Walker Zhao 提供补丁。
升级 luajit2 至 v2.1-20260415
- 新增 ffi.abi("dualnum")。感谢 Mike Pall 提供补丁。
- 允许在跳转范围之外分配 mcode 以支持代码。感谢 Mike Pall 提供补丁。
- ARM64：如果工具链指示，启用非对齐访问。感谢 Mike Pall 提供补丁。
- ARM64：修复大于 2GB 分支目标的反汇编。感谢 Mike Pall 提供补丁。
- ARM64：修复某些子字长加载/存储的反汇编。感谢 Mike Pall 提供补丁。
- ARM64：更多 ARM BTI 修复。感谢 Mike Pall 提供补丁。
- 避免记录由于 VM 钩子调用导致的干扰。感谢 Mike Pall 提供补丁。
- 避免对内部注册表键使用次正规数。感谢 Mike Pall 提供补丁。
- 回退 MSVC LJ_CONSTF 声明。感谢 Mike Pall 提供补丁。
- bcsave.lua：新增 ppc64 和 ppc64le 映射。感谢 Piotr Kubaj 提供补丁。
- 缺陷修复：修复使用 LUA_USE_TRACE_LOGS 定义时的构建失败问题。感谢 lijunlong 提供补丁。
- DUALNUM：为 FORI 槽添加缺失的类型转换。感谢 Mike Pall 提供补丁。
- DUALNUM：修复一元减法的窄化问题。感谢 Mike Pall 提供补丁。
- DUALNUM：修复因之前变更导致的循环记录问题。感谢 Mike Pall 提供补丁。
- DUALNUM：改进/修复一元减法的边缘情况。感谢 Mike Pall 提供补丁。
- ELF/Mach-O：强制公共 API 函数的默认可见性。感谢 Mike Pall 提供补丁。
- FFI：避免悬空的 cts->L。感谢 Mike Pall 提供补丁。
- FFI：修复 JIT 编译器中的构造函数索引解析。感谢 Mike Pall 提供补丁。
- FFI：修复 64 位平台上的指针差值运算。感谢 Mike Pall 提供补丁。
- FFI：缩小压缩位域的容器。感谢 Mike Pall 提供补丁。
- 修复编译器警告。感谢 Mike Pall 提供补丁。
- 修复为 string.byte/sub/find 生成 IR 时的边缘情况。感谢 Mike Pall 提供补丁。
- 修复记录 string.byte/sub 时的边缘情况。感谢 Mike Pall 提供补丁。
- 修复栈调整时的 G->jit_base 重定位。感谢 Mike Pall 提供补丁。
- 修复 minilua 中 bit.tohex 的未定义行为。感谢 Mike Pall 提供补丁。
- 修复 MSVC LJ_CONSTF 声明。感谢 Mike Pall 提供补丁。
- 修复有限精度浮点数转换的 string.format。感谢 Mike Pall 提供补丁。
- 修复终结器中 VM 事件的错误处理。感谢 Mike Pall 提供补丁。
- 忽略 PDB 文件的 git 跟踪。感谢 Mike Pall 提供补丁。
- 实现 s390x 的双精度到整数转换 (#256)。感谢 Ilya Leoshkevich 提供补丁。
- macOS：更改 Mach-O 目标文件布局以满足 XCode 15.0 要求。感谢 Mike Pall 提供补丁。
- MIPS64：避免 lj_vm_exit_interp 中的非对齐加载。感谢 Mike Pall 提供补丁。
- PPC：修复软浮点 lj_num2u64()。感谢 Mike Pall 提供补丁。
- 防止 unpack() 中的误报 sanitizer 警告。感谢 Mike Pall 提供补丁。
- 防止记录带有 -0 步长或 NaN 值的循环。感谢 Mike Pall 提供补丁。
- 防止在记录函数头时清除快照。感谢 Mike Pall 提供补丁。
- 移除 FP 转换的编译器标志（现已不必要）。感谢 Mike Pall 提供补丁。
- 移除无意义的 GCC/MSVC const 函数属性。感谢 Mike Pall 提供补丁。
- 在单独的状态中运行 VM 事件和终结器。感谢 Mike Pall 提供补丁。
- s390x：简化 ceil/floor 代码 (#246)。感谢 J. Neuschäfer 提供补丁。
- 统一 Lua 数字到 FFI 整数的转换。感谢 Mike Pall 提供补丁。
- x64/!LJ_GC64：无 JIT 构建也需要分配限制。感谢 Mike Pall 提供补丁。
- x86/x64：反向移植 math.min()/math.max() 参数检查的修复。感谢 Mike Pall 提供补丁。
升级 ngx_postgres 至 v1.1
- 缺陷修复：在被其他模块包装时恢复 postgres 的 peer 数据。感谢 lijunlong 提供补丁。
升级 lua-resty-mysql 至 v0.30
- 新功能：新增对 ed25519 的支持。感谢 lijunlong 提供补丁。
升级 lua-resty-string 至 v0.17
- 新功能：新增 AES-256-CTR 绑定并复用缓冲区。感谢 ^_^ 提供补丁。
升级 lua-cjson 至 v2.1.0.17
- 缺陷修复：修复解码超出 lua_Integer 范围的数字时被截断的问题 (#116)。感谢 James McCoy 提供补丁。
- 新功能：新增在解码时允许注释的选项。感谢 skewb1k 提供补丁。
- 新功能：新增对编码输出进行缩进的选项。感谢 skewb1k 提供补丁。
- 缺陷修复：消除显式将指针转换为 int 的警告。感谢 Deyan Dobromirov 提供补丁。
升级 drizzle-nginx-module 至 v0.1.13
- 缺陷修复：将 peer 数据存储在模块 ctx 中，以便在上游包装器中得以保留 (#52)。感谢 lijunlong 提供补丁。

Nginx 重大变更

本版本基于 nginx 1.31.1 核心，其 upstream 模块包含若干重要的行为变更。从早期版本升级的用户请特别留意以下内容：

proxy_http_version 指令的默认值已从 1.0 修改为 1.1。
自 nginx 1.29.7 起，upstream 的 keepalive 连接默认启用，每个 worker 进程默认的连接数上限为 32。
如果你在 balancer_by_lua_block 中使用 ngx.balancer.enable_keepalive API 来管理上游 keepalive 连接，请勿在对应的 upstream {} 块中同时配置 nginx 的 keepalive 指令。这两种机制相互冲突，不可同时使用。
自 nginx 1.29.4 起，请求行、Host 请求头以及 HTTP/2 / HTTP/3 中 :authority 伪头里 host 和 port 的校验改为严格遵循 RFC 3986。具体表现为：
- host 部分只允许 unreserved（A-Z a-z 0-9 - . _ ~）、pct-encoded 和 sub-delims（! $ & ' ( ) * + , ; =）字符；不再接受空格、控制字符以及其他非 ASCII 字符。
- IPv6 字面量必须使用方括号包裹，例如 [::1]:8080。
- port 部分只允许纯数字；空端口（如 example.com:）或包含字母的端口（如 example.com:80a）会被直接拒绝。
- HTTP/2 / HTTP/3 客户端构造请求时，:authority 伪头同样受此约束。升级前请自查所有可能向 OpenResty 发送非标准 Host / :authority 的来源（内部 RPC 框架、服务网格 sidecar、压测工具、手工构造的 HTTP 客户端等），否则原本能通的请求可能会返回 400。

完整更新日志

相较于上一个正式版本 1.29.2.5，您可以在 1.31.1.x 更新日志页面浏览完整的变更记录。

测试

我们在 Amazon EC2 测试集群上进行了广泛的测试，确保所有组件（包括 Nginx 核心）都能协同稳定运行。最新的测试报告可随时在此处查阅：

https://qa.openresty.org/

此外，我们自己的全球 CDN 网络（我们称之为“迷你 CDN”）也始终基于最新开源版本的 OpenResty 来运行我们的 OpenResty Edge 商业软件，为 openresty.org 和 openresty.com 网站提供动力。更多详情请访问 https://openresty.com/。