简介

Nginx 作为一款高性能的 Web 服务器，其功能可以通过多种模块进行扩展。其中，NJS 模块为 Nginx 提供了强大的 JavaScript 处理能力，使得开发者可以在服务器端使用 JavaScript 进行复杂的逻辑处理。本文将详细介绍如何在 Nginx 中安装和使用 NJS，并通过具体示例展示其强大功能。

使用案例

• 访问控制和安全检查：在请求到达上游服务器之前，NJS 可以用于进行复杂的访问控制和安全检查。例如，可以通过 NJS 脚本验证请求的来源、检查请求头中的认证信息，以及根据请求参数进行动态路由。
• 操作响应标头：NJS 还可以用于操作响应标头。开发者可以在响应返回给客户端之前，动态添加、修改或删除响应标头。这对于实现安全标头（如 Content-Security-Policy）、缓存控制等功能非常有用。
• 编写灵活的异步内容处理程序和过滤器：NJS 支持异步操作，使得开发者可以编写灵活的异步内容处理程序和过滤器。例如，可以通过 NJS 实现内容压缩、加密、日志记录等功能。

基本 HTTP 示例

安装 NJS 脚本语言

要在 Nginx 中使用 NJS，首先需要安装 NJS 模块。具体步骤如下：

1. 下载并安装 Nginx，确保包含 NJS 模块。
2. 安装 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 模块。