njs脚本语言

njs 是 JavaScript 语言的子集，允许扩展 nginx 功能。njs 是根据 ECMAScript 5.1 （严格模式）创建的，并带有一些 ECMAScript 6 及更高版本的扩展。合规性仍在不断发展。

• 下载并安装
• 变化
• 参考
• 例子
• 安全
• 兼容性
• 命令行界面
• 了解预加载对象
• 经过测试的操作系统和平台

• ngx_http_js_模块
• ngx_stream_js_模块

• 使用 TypeScript 定义文件编写 njs 代码
• 将节点模块与 njs 一起使用

用例

• 在请求到达上游服务器之前，njs 中进行复杂的访问控制和安全检查
• 操作响应标头
• 编写灵活的异步内容处理程序和过滤器

有关更多 njs 用例， 请参阅示例和 博客文章。

基本 HTTP 示例

在nginx中使用njs：

• 安装njs脚本语言

• 创建一个 njs 脚本文件，例如http.js. 有关 njs 属性和方法的列表， 请参阅参考资料。

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

• 在该nginx.conf文件中，启用 ngx_http_js_module模块并 使用脚本文件指定js_importhttp.js指令：

  load_module modules/ngx_http_js_module.so;
  
  events {}
  
  http {
      js_import http.js;
  
      server {
          listen 8000;
  
          location / {
              js_content http.hello;
          }
      }
  }
  

还有一个独立的命令行实用程序，可以独立于 nginx 使用，进行 njs 开发和调试。

经过测试的操作系统和平台

• FreeBSD/amd64；
• Linux/x86、amd64、arm64、ppc64el；
• Solaris 11 / amd64；
• macOS/x86_64；

在 nginx.conf 2018 上的演示