专栏 > njs

njs（NGINX JavaScript）是 NGINX 推出的轻量级 JavaScript 子集，通过 `ngx_http_js_module` 模块可在 NGINX 中实现 location 处理、变量定义、响应过滤等核心能力。相比于传统 NGINX 配置，njs 赋予了 NGINX 更灵活的编程能力，无需依赖第三方模块即可完成复杂的请求/响应处理逻辑。本文将从配置入门、核心指令、实战案例到高级特性，全面讲解 njs 的使用方法。

NJS（NGINX JavaScript）的 `fs` 模块为 NGINX 网关层提供了完整的文件系统操作能力，支持文件读写、目录管理、权限校验、符号链接处理等核心功能，同时兼容同步 API 和异步 Promise API（0.3.9+）。无论是读取配置文件、记录访问日志，还是处理静态资源元信息，`fs` 模块都是 NJS 实现本地文件交互的核心工具。本文将全面解析 `fs` 模块的核心 API、数据对象及实战场景，结合版本兼容要点讲解最佳实践。

Base64 是一种通用的二进制到文本的编码方式，常用于处理特殊字符传输、加密数据序列化等场景。NJS（NGINX JavaScript）内置了 Web 标准的 `atob()` 和 `btoa()` 方法，无需依赖第三方模块即可实现高效的 Base64 编解码，是 NGINX 网关层处理数据编码的轻量解决方案。本文将详细讲解这两个方法的用法、适用场景及注意事项，结合实战示例展示其在 NJS 中的典型应用。

NJS（NGINX JavaScript）的 HTTP 请求对象（通常简写为 `r`）是 `ngx_http_js_module` 模块的核心，封装了客户端请求的所有关键信息（参数、头信息、请求体等），并提供了响应构建、子请求、日志输出等核心能力。从请求解析到响应发送，`r` 对象贯穿整个 NGINX 请求生命周期，是实现网关层逻辑（如参数校验、请求转发、响应改写）的基础。本文将全面解析 `r` 对象的核心属性与方法，结合实战场景讲解其使用技巧与版本兼容要点。

NJS（NGINX JavaScript）从 0.8.0 版本开始引入 `ngx.shared` 全局对象，提供了基于共享内存的字典（SharedDict）能力，解决了 NGINX 多 Worker 进程间数据隔离的问题。通过 SharedDict，开发者可在 NGINX 网关层实现轻量级缓存、计数器、限流标记等跨进程共享数据的场景，本文将全面讲解 `ngx.shared` 的配置方式、核心 API 及实战应用。

NJS（NGINX JavaScript）作为 NGINX 原生集成的轻量级 JavaScript 运行时，提供了全局 `njs` 对象（自 0.2.0 版本引入），它是当前 VM（虚拟机）实例的直接映射，封装了版本查询、内存监控、事件监听等核心能力。掌握 `njs` 全局对象的 API，能帮助开发者更精准地调试、监控和管控 NJS 运行时，本文将全面解析 `njs` 对象的核心属性与方法，并结合实战场景讲解其应用价值。

NJS（NGINX JavaScript）是 NGINX 内置的 JavaScript 运行时，其 `crypto` 模块提供了轻量且高效的加密功能，核心包含 `createHash()` 和 `createHmac()` 两大核心 API，可满足 NGINX 配置中常见的哈希计算、签名验证等需求。本文将结合 NJS 内置 `crypto` 模块的特性，从零讲解 Hash 和 HMAC 的使用方法、核心差异及实战场景。