js_access
js_access 指令允许使用自定义 JavaScript 在 NGINX 的 stream 上下文中处理访问控制。
NGINX njs dynamic modules
·
streamstream server
语法js_access function_name;
默认值none
上下文stream, stream server
参数1
说明
js_access 指令是 NGINX JavaScript 模块的一部分，该模块使得在 NGINX 配置中可以使用 JavaScript 执行各种操作。具体来说，在 stream 模块的上下文中，此指令允许你指定一个 JavaScript 函数，该函数将在确定网络连接的访问控制时被调用。这样可以实现超出标准配置选项的复杂访问规则，利用 JavaScript 的灵活性和表达能力。
此指令需要一个参数：将处理访问逻辑的 JavaScript 函数的名称。当客户端建立连接时，NGINX 会调用指定的 JavaScript 函数，并传递连接详情，这些详情可用于在运行时决定是否允许或拒绝访问。JavaScript 的灵活性让你可以处理各种参数并实现复杂逻辑，例如将 IP 地址与动态列表比对、与外部服务集成或应用速率限制。
要有效使用 js_access，需要对 NGINX 的事件模型和 NJS module 提供的 JavaScript 执行环境有良好的理解。必须确保 JavaScript 代码是非阻塞的，以保持对传入连接的高性能和可扩展性。
配置示例
stream {
js_access my_access_function;
server {
listen 12345;
proxy_pass backend_servers;
}
}⚠
确保在配置中引用 JavaScript 函数之前，该函数已被定义并正确加载。
⚠
如果 JavaScript 函数包含阻塞操作或长时间运行的逻辑，性能可能会受到影响。
⚠
调试 JavaScript 错误可能需要额外的日志配置来捕获该函数返回的错误。