厉害了，可以在 Nginx 中运行 JavaScript！

浅浅的花香味﹌ 2022-09-10 07:24 248阅读 0赞

点击上方 前端Q，关注公众号

回复加群，加入前端Q技术交流群

引言

Nginx 作为市场占有率最高的Web服务器，主打高性能、可扩展。自带了很多核心功能模块，并且也有大量的第三方模块。

Web 服务中灰度方案的实现，很多会采用 Nginx + Lua + Redis 方案。Lua 是一个轻量级的脚本语言，体积小、启动速度快、性能高。通过 lua-nginx-module 模块将 Lua 语言嵌入到 Nginx 中，可以使用 Lua 脚本扩展 Nginx 功能，并可以访问 MySQL、Redis 等数据库。

![da7add94a8c82c642355d451dde56d99.png][]

Lua 虽然是个强大的脚本语言，但过于小众。Nginx 团队选择非常流行的 JavaScript 研发 NGINX JavaScript 模块 (njs)，让更多工程师可以使用 JavaScript 来扩展 Nginx 功能，从而更好的发展 Nginx 社区生态。

![837eba7ae2dbff77a34bf7a7152e90a3.png][]

#### NGINX JavaScript 简介 ####

NGINX JavaScript 简称 njs，是 JavaScript 语言的子集，实现了部分 ECMAScript 5.1(strict mode)规范和 ECMAScript 6 规范，可以使用 njs 来扩展 Nginx 功能。

##### njs 与 Node.js、JavaScript 的区别 #####

一、运行时不同

Node.js 使用 V8 引擎，njs 是专门为 Nginx 定制设计的运行时。Node.js 使用 V8 引擎在内存中有一个持久化的 JavaScript 虚拟机 (VM) 并执行垃圾收集以进行内存管理；而 njs 是专门为 Nginx 设计，非常轻量，会为每个请求初始化一个新的 JavaScript VM 和必要的内存，并在请求完成时释放内存。

二、语言规范差异

JavaScript 的规范是由 ECMAScript 标准定义，随着标准版本的更新迭代，会支持更多的语言功能；njs 自研的服务端运行时，更多的优先支撑服务于 Nginx，只实现了 ECMAScript 5.1 和部分 ECMAScript 6，实现更多标准规范的同时，更多会考虑是否是 Nginx 所需要的。

##### njs 安装&配置 #####

安装 nginx-module-njs 动态模块，需要 Nginx 版本为 1.9.11 之后支持动态模块的载入。

yum install nginx-module-njs

安装后，在配置文件 nginx.conf 中需要使用 load\_module 指令加载 njs 动态模块。

load_module modules/ngx_http_js_module.so;

#### njs 基本使用 ####

##### Hello World #####

nginx.conf:

http {
        js_import http.js;
        # or js_import http from http.js;
    
        server {
            listen 8000;
    
            location / {
                js_content http.hello;
            }
        }
    }

http.js:

function hello(r) {
        r.return(200, "Hello world!");
    }
    
    export default { hello };

js\_import : 导入一个 njs 模块，没有指定模块名称则默认为文件名称。

js\_content : 使用 njs 模块里导出的方法处理这个请求。

##### HTTP Proxying #####

使用 njs 模块处理 HTTP 请求，并使用 subrequest 发起子请求。

nginx.conf:

js_import http.js;
    
    location /start {
        js_content http.content;
    }
    
    location /foo {
        proxy_pass <http://backend1>;
    }
    
    location /bar {
        proxy_pass <http://backend2>;
    }

http.js:

r.subrequest : 可以去请求内部的其他 API ，headers 和该请求相同，并且可以在 location 块里使用 proxy\_set\_header 来设置或覆盖原来的 header。

##### 自定义日志输出格式 #####

使用 njs 定制 Nginx 日志的输出格式。

nginx.js:

js_import  logging.js;
    js_set     $access_log_headers logging.kvAccess;
    log_format kvpairs $access_log_headers;
    
    server {
        listen 80;
        root /usr/share/nginx/html;
        access_log /var/log/nginx/access.log kvpairs;
    }

logging.js:

js\_set : 将 njs 模块里的 kvAccess 方法执行后，执行结果放到 $access\_log\_headers 变量中。但如果只被引用在 log\_format 中，则只会在日志记录阶段被执行。

r : HTTP request 对象。属性列表：http://nginx.org/en/docs/njs/reference.html\#http

##### 访问数据库 #####

一、访问 Redis

使用 redis2-nginx-module 动态模块，结合 subrequest 来访问 Redis 数据。

nginx.conf:

js_import http.js;
    
    # GET /redis_get?key=some_key
    location = /redis_get {
         # 解码 uri 中的参数 key，赋值到变量 $key
         set_unescape_uri $key $arg_key;
         redis2_query get $key;
         redis2_pass 127.0.0.1:6379;
    }
    
    # GET /redis_set?key=one&val=first%20value
    location = /redis_set {
         set_unescape_uri $key $arg_key;
         set_unescape_uri $val $arg_val;
         redis2_query set $key $val;
         redis2_pass 127.0.0.1:6379;
    }
    
    # GET /get_redis_data?key=some_key
    location /get_redis_data {
        js_content http.get_redis_data;
    }

http.js:

set\_unescape\_uri ：解码 uri 中参数的 %XX 编码。

redis2\_query : 执行的 Redis 命令。

redis2\_pass : Redis 后端服务。

> redis2\_pass 返回值为类似 redis-cli 执行后的返回值，需要有一个 parser 来解析是否执行成。

二、访问 MySQL

使用 drizzle-nginx-module 动态模块，结合 subrequest 来访问 MySQL 数据。

nginx.conf:

upstream backend {
        drizzle_server 127.0.0.1:3306 dbname=test
            password=some_pass user=monty protocol=mysql;
    }
    
    server {
        js_import http.js;
    
        location /mysql {
             set_unescape_uri $name $arg_name;
             # 为防止 SQL 注入攻击，使用 set_quote_sql_str 来设置 sql 语句中的变量
             set_quote_sql_str $quoted_name $name;
    
             drizzle_query "select * from cats where name = $quoted_name";
             drizzle_pass backend;
    
             drizzle_connect_timeout    500ms; # default 60s
             drizzle_send_query_timeout 2s;    # default 60s
             drizzle_recv_cols_timeout  1s;    # default 60s
             drizzle_recv_rows_timeout  1s;    # default 60s
        }
    
        # GET /get_mysql_data?name=cat_name
        location /get_mysql_data {
            js_content http.get_mysql_data;
        }
    }

http.js:

set\_quote\_sql\_str : 为防止 SQL 注入攻击，来设置 sql 语句中的变量。

drizzle\_query : 执行的 SQL 语句。

drizzle\_pass : Drizzle 或 MySQL 服务的 upstream。

#### 结语 ####

在 njs 之前，Nginx+Lua 生态虽然已日趋成熟，但 Nginx 毕竟是一个 Web 服务器，JavaScript 作为 Web 开发的最流行的语言，可以使用 JavaScript 生态来扩展 Nginx 的功能，可能会更加的有一些想象力做更多的事情。

#### 参考文献 ####

2021年06月 Web 服务器排行榜 https://news.netcraft.com/archives/2021/06/29/june-2021-web-server-survey.html

njs scripting language https://nginx.org/en/docs/njs/

NJS Learning Materials https://github.com/soulteary/njs-learning-materials

Harnessing the Power and Convenience of JavaScript for Each Request with the   
NGINX JavaScript Module https://www.nginx.com/blog/harnessing-power-  
convenience-of-javascript-for-each-request-with-nginx-javascript-module

Introducing Nginx NJS https://www.mywaiting.com/weblogs/i

关于本文  
作者：@whilefor  
原文：https://zhuanlan.zhihu.com/p/393788937

声明：文章著作权归作者所有，如有侵权，请联系小编删除。

![6b3efbd5124aae58c90ac6811871d5a9.png][]

往期推荐

[大厂面试过程复盘(微信/阿里/头条,附答案篇)][Link 1]

![6750367eeaae73b6098d2b350747c5af.png][]

[面试题：说说事件循环机制(满分答案来了)][Link 2]

![531b1a6bc29b45cac7b45c28485150de.png][]

[专心工作只想搞钱的前端女程序员的2020][2020]

![66dc38d15e672872393ed3dd2f5f8ac0.png][]

最后

*  欢迎加我微信，拉你进技术群，长期交流学习...  
    
 *  欢迎关注「前端Q」,认真学前端，做个专业的技术人...

![7d3ec0fbdefad25e5cd5c7945dfc9587.png][]

![475f5c95ee9caefd77d40c24857d2837.png][]

点个**在看**支持我吧

![595061a6842e1118f539b93f6e59b5f5.gif][]

[da7add94a8c82c642355d451dde56d99.png]: /images/20220829/62b29b0794114aea861114d8de42cbcd.png
[837eba7ae2dbff77a34bf7a7152e90a3.png]: /images/20220829/326347d0d15f4f02b3d25fde78d73d67.png
[6b3efbd5124aae58c90ac6811871d5a9.png]: /images/20220829/72c40c1674b34a92b1c34a845648b6fe.png
[Link 1]: http://mp.weixin.qq.com/s?__biz=MzI0MzIyMDM5Ng%3D%3D&chksm=f175e460c6026d76bcdfc6dd42cfe80a3f14ea832d1922d65043f666d6de22bd17b09e779ed9&idx=2&mid=2649829027&scene=21&sn=1a433047a8d6e8af65012bfa0bd27e3f#wechat_redirect
[6750367eeaae73b6098d2b350747c5af.png]: /images/20220829/43ce789838324c959ae535053319ac57.png
[Link 2]: http://mp.weixin.qq.com/s?__biz=MzI0MzIyMDM5Ng%3D%3D&chksm=f175ef9ec60266880a86f33085ff43f95e3180846c5f139cb9b1b33c3245201157f39d949e9a&idx=1&mid=2649826653&scene=21&sn=9e5e2de78a8ef4de3820769ff3ab7c02#wechat_redirect
[531b1a6bc29b45cac7b45c28485150de.png]: /images/20220829/f53478b7dbe44dfb875855bf21c3e9cd.png
[2020]: http://mp.weixin.qq.com/s?__biz=MzI0MzIyMDM5Ng%3D%3D&chksm=f175f306c6027a1029967cde600630a5107fbbfdd125b64ba3f2c9d9b570b102162ab4c3b373&idx=1&mid=2649831877&scene=21&sn=9352cf4624308602c50a6fd10379d132#wechat_redirect
[66dc38d15e672872393ed3dd2f5f8ac0.png]: /images/20220829/8d0a7e150f7d45dd93def6bbb655b223.png
[7d3ec0fbdefad25e5cd5c7945dfc9587.png]: /images/20220829/e11a95d6ea1144f7bec6727725e12d18.png
[475f5c95ee9caefd77d40c24857d2837.png]: /images/20220829/b60196d3b170420ebd606c9df67c778c.png
[595061a6842e1118f539b93f6e59b5f5.gif]: /images/20220829/73288a2ca0d7426da65dcc7ef1b64aa4.png