简介
Nginx 作为一款高性能的 Web 服务器，其功能可以通过多种模块进行扩展。其中，NJS 模块为 Nginx 提供了强大的 JavaScript 处理能力，使得开发者可以在服务器端使用 JavaScript 进行复杂的逻辑处理。本文将详细介绍如何在 Nginx 中安装和使用 NJS，并通过具体示例展示其强大功能。
使用案例
- 访问控制和安全检查：在请求到达上游服务器之前，NJS 可以用于进行复杂的访问控制和安全检查。例如，可以通过 NJS 脚本验证请求的来源、检查请求头中的认证信息，以及根据请求参数进行动态路由。
- 操作响应标头：NJS 还可以用于操作响应标头。开发者可以在响应返回给客户端之前，动态添加、修改或删除响应标头。这对于实现安全标头（如 Content-Security-Policy）、缓存控制等功能非常有用。
- 编写灵活的异步内容处理程序和过滤器：NJS 支持异步操作，使得开发者可以编写灵活的异步内容处理程序和过滤器。例如，可以通过 NJS 实现内容压缩、加密、日志记录等功能。
基本 HTTP 示例
安装 NJS 脚本语言
要在 Nginx 中使用 NJS，首先需要安装 NJS 模块。具体步骤如下：
- 下载并安装 Nginx，确保包含 NJS 模块。
- 安装 Nginx NJS 模块的动态库。
创建 NJS 脚本文件
创建一个 NJS 脚本文件，例如 http.js。在该文件中，定义一个简单的处理函数：
function hello(r) {
r.return(200, "Hello world!");
}
export default {hello};
在这个示例中，我们定义了一个 hello 函数，该函数接收一个请求对象 r，并返回状态码 200 和文本 "Hello world!"。
配置 Nginx
在 Nginx 配置文件 nginx.conf 中，启用 NJS 模块并导入 http.js 脚本文件：
load_module modules/ngx_http_js_module.so;
events {}
http {
js_import http.js;
server {
listen 8000;
location / {
js_content http.hello;
}
}
}
在这个配置中，我们加载了 NJS 模块，并通过 js_import 指令导入 http.js 脚本。在服务器配置中，我们设置监听端口为 8000，并在 location 块中使用 js_content 指令指定处理函数为 http.js 中的 hello 函数。
独立命令行实用程序
NJS 还提供了一个独立的命令行实用程序，可以独立于 Nginx 使用，用于 NJS 开发和调试。这使得开发者可以在不启动 Nginx 服务器的情况下，快速测试和调试 NJS 脚本。
经过测试的操作系统和平台
NJS 模块已经在多个操作系统和平台上进行了测试，确保其稳定性和兼容性。以下是经过测试的操作系统和平台列表：
- FreeBSD/amd64
- Linux/x86、amd64、arm64、ppc64el
- Solaris 11 / amd64
- macOS/x86_64
这些平台上，NJS 模块均能正常工作，开发者可以根据需要选择合适的平台进行部署。
参考资料
为了帮助开发者更好地使用 NJS，Nginx 官方提供了详细的 NJS 属性和方法参考资料。开发者可以在 Nginx 官方网站上查阅这些资料，了解 NJS 的所有功能和用法。
资料地址：
https://nginx.org/en/docs/njs/
总结
NJS 作为 Nginx 的一个强大扩展模块，为开发者提供了在服务器端使用 JavaScript 进行高级处理的能力。通过 NJS，开发者可以实现复杂的访问控制、安全检查、操作响应标头，以及编写灵活的异步内容处理程序和过滤器。本文通过一个基本的 HTTP 示例，详细介绍了如何在 Nginx 中安装和使用 NJS，并提供了配置示例和经过测试的平台列表。希望这些内容能够帮助开发者更好地理解和使用 NJS 模块。