Nginx与脚本语言轶事
2025-07-17 11:02:41 
阿炯
Nginx之父西索夫（Igor Sysoev）一直有个梦想：构建其与脚本语言的运行时，从最初的Perl、Python再到Lua，现发展到JavaScript，Nginx一直在努力。
本书主要就Nginx与各大脚本语言的交互做一些收录，供读者参考。
CGI通用网关与Nginx
多语言动态 Web 应用服务器-Nginx Unit
Nginx-Perl
Nginx-Perl配置使用入门
基于Nginx和Lua的Web平台-OpenResty
Nginx的JavaScript脚本语言-njs
正式拥抱现代 JavaScript
正式拥抱现代 JavaScript
Nginx虽然快，但“太静态”也是它的一个老问题。随着前后端分离、边缘计算、接口鉴权、灰度路由等需求变多，越来越多开发者发现，仅靠传统的配置语法已经不够用了。我们需要在转发请求前“想一想”、拦截一下、判断一下，有时候还得去后端接口问一嘴。于是njs这个 Nginx 官方推出的 JavaScript 模块，终于让人可以在配置里写点“逻辑”。
njs：灵活但不够现代
一开始，njs 确实解决了不少痛点。但遗憾的是，它早期的语法支持非常有限，大致相当于 ES5 + 一丢丢 ES6。这对于写点简单逻辑还够用，但对于习惯了 import/export、async/await 的现代 JavaScript 开发者来说，简直像突然穿越回了 2012 年。
模块不能用，异步没法写，语法老旧，开发体验也跟不上。用 JavaScript 写配置这件事听上去是件美事，但真写起来经常让人感到“绑着手脚跳舞”。
新引擎来了，JS 真正落地 Nginx
就在2025年年中，Nginx 官方悄悄宣布：njs 引入对 QuickJS 的支持。这个变化乍一看不大，但对 JavaScript 开发者来说，影响是质的飞跃。
QuickJS 是一个超轻量 JavaScript 引擎，体积只有 367 KiB，却支持完整的 ES2023 标准。这意味着你可以在 Nginx 脚本中使用：
1.import/export 模块系统
2.async/await 异步语法
3.异步生成器、Proxy、BigInt 等现代能力
这可不是“小打小闹”的扩展，而是真正意义上的“现代 JavaScript 编程”跑在 Nginx 里了。
JS 能在 Nginx 里做什么
以前你可能只能在配置里写点 if 判断、拼个 URI 之类的小逻辑，现在则可以做更“工程化”的事：
1.根据请求内容动态分发路由，像写 Express 一样
2.做一个轻量级的接口验证逻辑，不用走后端
3.异步生成日志数据，根据条件写不同格式
4.自定义 header、body 处理逻辑，更灵活地转发请求
比如下面这个“接口认证”代码：
async function auth(r) {
const resp = await ngx.fetch("http://auth-service/validate", {
method: "POST",
body: JSON.stringify({ token: r.headersIn['Authorization'] })
});
if (resp.status !== 200) {
r.return(401, "Unauthorized");
}
}
这很 Node.js，但它运行在 Nginx 里，零依赖，零服务扩展。不妨换个角度看这个问题：Nginx 为啥愿意引入 JS？
1.JS 开发者太多了，门槛低、学习成本小
2.写配置逻辑比 DSL 清晰太多，容易调试
3.同样的逻辑，写 JS 更灵活、可读性强
4.工具链一体化，前后端协同更自然
以前大家爱用 Lua，但 Lua 太冷门，生态小，现代语法也不行。Node.js 太重，把整个引擎塞进去不现实。而 QuickJS 折中得刚刚好：够现代、够小、够快，完美贴合 Nginx 的设计哲学。
其实 JavaScript “进入” Nginx，不是一夜之间发生的。
1.一开始，只是能在配置里塞点小脚本
2.后来有了 njs，可以写逻辑函数
3.现在有了 QuickJS，能跑完整的现代 JS
一步步来，几乎没怎么让圈子惊奇，但回过头看，它已经成为 Nginx 脚本化能力的核心语言。这不像 Node.js 那样大张旗鼓搞服务端开发，更像是 JavaScript 在基础设施领域的一次“迂回作战”。
如果想知道具体能在哪用到，现在已经有不少落地场景：
1.动态路由：按地域、时间、设备类型转发到不同服务
2.自定义日志：记录用户行为、请求详情、命中规则等
3.边缘拦截策略：做风控前置、做 IP 黑名单、做认证缓存
4.前端工具联动：配合 Vite、Bun 做部署逻辑控制等
总之，原来只能在后端服务里搞的逻辑，现在可以在 Nginx 层就“截胡”了。
JavaScript 一开始只是写网页的；后来写应用、写服务端、写桌面；现在连 Web Server 配置都能写了。从 Node 到 Deno 到 Bun，再到 njs + QuickJS，JS 正在成为“写啥都行”的万能胶水语言。这一次，它没试图取代什么，只是在最不起眼的角落，把事情做得更顺、更灵活、更现代。Nginx 还是那个 Nginx，但现在它运行系统中多了一块 JavaScript 的芯。
本书主要就Nginx与各大脚本语言的交互做一些收录，供读者参考。
CGI通用网关与Nginx
多语言动态 Web 应用服务器-Nginx Unit
Nginx-Perl
Nginx-Perl配置使用入门
基于Nginx和Lua的Web平台-OpenResty
Nginx的JavaScript脚本语言-njs
正式拥抱现代 JavaScript
正式拥抱现代 JavaScript
Nginx虽然快，但“太静态”也是它的一个老问题。随着前后端分离、边缘计算、接口鉴权、灰度路由等需求变多，越来越多开发者发现，仅靠传统的配置语法已经不够用了。我们需要在转发请求前“想一想”、拦截一下、判断一下，有时候还得去后端接口问一嘴。于是njs这个 Nginx 官方推出的 JavaScript 模块，终于让人可以在配置里写点“逻辑”。
njs：灵活但不够现代
一开始，njs 确实解决了不少痛点。但遗憾的是，它早期的语法支持非常有限，大致相当于 ES5 + 一丢丢 ES6。这对于写点简单逻辑还够用，但对于习惯了 import/export、async/await 的现代 JavaScript 开发者来说，简直像突然穿越回了 2012 年。
模块不能用，异步没法写，语法老旧，开发体验也跟不上。用 JavaScript 写配置这件事听上去是件美事，但真写起来经常让人感到“绑着手脚跳舞”。
新引擎来了，JS 真正落地 Nginx
就在2025年年中，Nginx 官方悄悄宣布：njs 引入对 QuickJS 的支持。这个变化乍一看不大，但对 JavaScript 开发者来说，影响是质的飞跃。
QuickJS 是一个超轻量 JavaScript 引擎，体积只有 367 KiB，却支持完整的 ES2023 标准。这意味着你可以在 Nginx 脚本中使用：
1.import/export 模块系统
2.async/await 异步语法
3.异步生成器、Proxy、BigInt 等现代能力
这可不是“小打小闹”的扩展，而是真正意义上的“现代 JavaScript 编程”跑在 Nginx 里了。
JS 能在 Nginx 里做什么
以前你可能只能在配置里写点 if 判断、拼个 URI 之类的小逻辑，现在则可以做更“工程化”的事：
1.根据请求内容动态分发路由，像写 Express 一样
2.做一个轻量级的接口验证逻辑，不用走后端
3.异步生成日志数据，根据条件写不同格式
4.自定义 header、body 处理逻辑，更灵活地转发请求
比如下面这个“接口认证”代码：
async function auth(r) {
const resp = await ngx.fetch("http://auth-service/validate", {
method: "POST",
body: JSON.stringify({ token: r.headersIn['Authorization'] })
});
if (resp.status !== 200) {
r.return(401, "Unauthorized");
}
}
这很 Node.js，但它运行在 Nginx 里，零依赖，零服务扩展。不妨换个角度看这个问题：Nginx 为啥愿意引入 JS？
1.JS 开发者太多了，门槛低、学习成本小
2.写配置逻辑比 DSL 清晰太多，容易调试
3.同样的逻辑，写 JS 更灵活、可读性强
4.工具链一体化，前后端协同更自然
以前大家爱用 Lua，但 Lua 太冷门，生态小，现代语法也不行。Node.js 太重，把整个引擎塞进去不现实。而 QuickJS 折中得刚刚好：够现代、够小、够快，完美贴合 Nginx 的设计哲学。
其实 JavaScript “进入” Nginx，不是一夜之间发生的。
1.一开始，只是能在配置里塞点小脚本
2.后来有了 njs，可以写逻辑函数
3.现在有了 QuickJS，能跑完整的现代 JS
一步步来，几乎没怎么让圈子惊奇，但回过头看，它已经成为 Nginx 脚本化能力的核心语言。这不像 Node.js 那样大张旗鼓搞服务端开发，更像是 JavaScript 在基础设施领域的一次“迂回作战”。
如果想知道具体能在哪用到，现在已经有不少落地场景：
1.动态路由：按地域、时间、设备类型转发到不同服务
2.自定义日志：记录用户行为、请求详情、命中规则等
3.边缘拦截策略：做风控前置、做 IP 黑名单、做认证缓存
4.前端工具联动：配合 Vite、Bun 做部署逻辑控制等
总之，原来只能在后端服务里搞的逻辑，现在可以在 Nginx 层就“截胡”了。
JavaScript 一开始只是写网页的；后来写应用、写服务端、写桌面；现在连 Web Server 配置都能写了。从 Node 到 Deno 到 Bun，再到 njs + QuickJS，JS 正在成为“写啥都行”的万能胶水语言。这一次，它没试图取代什么，只是在最不起眼的角落，把事情做得更顺、更灵活、更现代。Nginx 还是那个 Nginx，但现在它运行系统中多了一块 JavaScript 的芯。