DPTCloud
Quay lại danh sách
Tin tức công nghệ

Cấu hình Nginx JavaScript (njs) nâng cao để xử lý logic định tuyến phức tạp ngay tại tầng Web Server

3 tháng 6, 2026

Giới thiệu về Nginx JavaScript (njs) và xu hướng dịch chuyển logic về Edge

Trong kiến trúc hệ thống hiện đại, hiệu năng và độ trễ (latency) là hai yếu tố quyết định đến trải nghiệm người dùng và chi phí vận hành phần cứng. Thông thường, các logic nghiệp vụ phức tạp như định tuyến động dựa trên đặc điểm người dùng, kiểm tra quyền truy cập (authorization), hoặc thay đổi cấu trúc phản hồi (response modification) đều được xử lý ở tầng ứng dụng (Backend Application). Tuy nhiên, cách tiếp cận này vô tình tạo ra một mức độ lãng phí tài nguyên lớn khi mọi yêu cầu (request) đều phải đi qua tầng Web Server/Reverse Proxy rồi mới đến Backend.

Để giải quyết bài toán này, giải pháp dịch chuyển logic về biên (Edge Computing) hoặc xử lý ngay tại tầng Web Server đang trở thành một xu hướng tất yếu. Nginx JavaScript (njs) chính là câu trả lời mạnh mẽ từ F5 Nginx. Khác với module Lua (OpenResty) đòi hỏi một hệ sinh thái riêng, njs cho phép các kỹ sư hệ thống và lập trình viên sử dụng ngôn ngữ JavaScript tiêu chuẩn để can thiệp trực tiếp vào chu kỳ xử lý request của Nginx.

Tại sao nên chọn njs cho logic định tuyến phức tạp?

  • Hiệu năng vượt trội: njs được tích hợp trực tiếp vào tiến trình (worker process) của Nginx, thực thi mã nguồn nhanh chóng mà không làm giảm hiệu suất xử lý kết nối đồng thời của Web Server.
  • Dễ học và triển khai: Dựa trên tiêu chuẩn ECMAScript, các nhà phát triển không cần phải học một ngôn ngữ mới như Lua để viết cấu hình nâng cao.
  • An toàn tài nguyên: Kiến trúc của njs được thiết kế để cô lập bộ nhớ, đảm bảo một request lỗi không làm ảnh hưởng đến toàn bộ hệ thống Nginx.
---

Thiết lập môi trường và cấu hình cơ bản cho njs

Trước khi đi vào các kịch bản định tuyến nâng cao, chúng ta cần cài đặt module njs và liên kết nó vào tệp cấu hình chính của Nginx. Module này có sẵn trong kho lưu trữ chính thức của hầu hết các hệ điều hành phổ biến.

1. Cài đặt Module njs

Trên các hệ thống dựa trên Debian/Ubuntu, bạn có thể dễ dàng cài đặt thông qua lệnh apt:

sudo apt-get install nginx-module-njs

2. Tích hợp njs vào cấu hình Nginx

Tại tệp cấu hình chính nginx.conf, chúng ta cần nạp module và khai báo tệp script JavaScript sẽ sử dụng:

load_module modules/ngx_http_js_module.so;

events {
    worker_connections 1024;
}

http {
    # Nạp tệp JavaScript chứa logic xử lý
    js_import routing_logic from http/routing.js;

    server {
        listen 80;
        server_name enterprise.system.com;

        location /api/v1 {
            # Khai báo biến động được tính toán từ njs
            js_set $backend_target routing_logic.evaluateRouting;
            
            # Định tuyến request đến backend tương ứng
            proxy_pass http://$backend_target;
        }
    }
}
---

Xây dựng logic định tuyến phức tạp bằng JavaScript

Bây giờ, chúng ta sẽ tập trung vào việc viết mã nguồn JavaScript trong tệp http/routing.js để giải quyết các bài toán thực tế mà cấu hình Nginx thuần túy (Declarative Configuration) rất khó hoặc không thể xử lý linh hoạt.

Kịch bản: Định tuyến dựa trên JSON Payload và JWT Claims

Giả sử hệ thống của bạn cần phân phối request dựa trên cấp độ tài khoản của khách hàng (Tier: Premium, Gold, Silver) được mã hóa bên trong mã thông báo JWT hoặc dựa trên một trường cụ thể trong dữ liệu JSON gửi lên bằng phương thức POST.

Dưới đây là cách triển khai hàm evaluateRouting để bóc tách thông tin và đưa ra quyết định chuyển tiếp:

function evaluateRouting(r) {
    // 1. Kiểm tra nếu là phương thức POST và có dữ liệu
    if (r.method === 'POST' && r.requestText) {
        try {
            var body = JSON.parse(r.requestText);
            if (body.client_tier === 'premium') {
                return 'premium_backend_cluster';
            }
        } catch (e) {
            r.error("Không thể parse JSON body: " + e.message);
        }
    }

    // 2. Kiểm tra Header Authorization để lấy thông tin vùng miền (Region)
    var authHeader = r.headersIn['Authorization'];
    if (authHeader && authHeader.startsWith('Bearer ')) {
        var token = authHeader.substring(7);
        var jwtParts = token.split('.');
        if (jwtParts.length === 3) {
            try {
                // Giải mã phần Payload của JWT (Base64URL)
                var payload = JSON.parse(Buffer.from(jwtParts[1], 'base64').toString('utf8'));
                if (payload.region === 'asia') {
                    return 'asia_backend_upstream';
                } else if (payload.region === 'europe') {
                    return 'europe_backend_upstream';
                }
            } catch (err) {
                r.warn("Lỗi giải mã định tuyến JWT: " + err.message);
            }
        }
    }

    // 3. Phương án dự phòng mặc định (Fallback)
    return 'default_backend_cluster';
}

export default { evaluateRouting };

Trong đoạn mã trên, đối tượng r (Request Object) cung cấp toàn bộ các phương thức và thuộc tính cần thiết để truy cập vào Header, Method, và Body của HTTP request. Bằng việc xử lý đồng bộ và trả về tên của một upstream cluster, Nginx sẽ ngay lập tức gán giá trị đó cho biến $backend_target và thực hiện proxy_pass chính xác.

---

Tối ưu hóa hiệu năng và những lưu ý quan trọng khi triển khai njs

Mặc dù njs mang lại sự linh hoạt tuyệt vời, việc áp dụng nó vào môi trường Production đòi hỏi sự cẩn trọng cao độ để tránh gây nghẽn hệ thống (blocking).

Tránh các thao tác chặn dòng (Blocking Operations)

Kiến trúc của Nginx dựa trên mô hình lặp sự kiện đơn luồng (Single-threaded Event Loop). Do đó, bất kỳ mã JavaScript nào chạy tốn thời gian hoặc thực hiện các phép toán đồng bộ phức tạp (như vòng lặp vô hạn, xử lý chuỗi quá lớn) đều sẽ làm nghẽn tiến trình worker của Nginx, khiến các request khác bị trì hoãn.

  • Sử dụng biến thể không đồng bộ: Đối với các tác vụ cần truy vấn dữ liệu từ bên ngoài (ví dụ: gọi một API xác thực khác), hãy sử dụng phương thức r.subrequest() thay vì cố gắng thực hiện các kết nối HTTP đồng bộ từ bên trong script.
  • Giới hạn kích thước Request Body: Để đọc được dữ liệu body trong njs (qua r.requestText), bạn cần cấu hình directive client_body_in_single_buffer on; và client_max_body_size ở mức hợp lý (ví dụ: dưới 1MB) để tránh việc Nginx phải ghi dữ liệu ra đĩa cứng, làm giảm hiệu năng nghiêm trọng.

Quản lý lỗi chặt chẽ (Error Handling)

Mã nguồn JavaScript chạy trên njs cần được bao bọc cẩn thận trong các khối try...catch. Một ngoại lệ không được xử lý (unhandled exception) có thể dẫn đến việc Nginx trả về lỗi nội bộ 500 Internal Server Error cho người dùng cuối. Hãy luôn ghi nhận lỗi vào log của Nginx thông qua hàm r.error() hoặc r.warn() để đội ngũ vận hành (DevOps/SRE) dễ dàng theo dõi và khắc phục.

---

Lời kết

Nginx JavaScript (njs) là một bước tiến lớn giúp thu hẹp khoảng cách giữa phát triển phần mềm và quản trị hệ thống. Bằng cách đưa logic định tuyến phức tạp lên tầng Web Server, doanh nghiệp không chỉ tiết kiệm được tài nguyên tính toán cho hạ tầng Backend mà còn tăng tốc độ phản hồi đáng kể cho hệ thống. Hãy bắt đầu từ những logic đơn giản như phân tách lưu lượng A/B Testing, sau đó nâng cấp dần lên các mô hình định tuyến thông minh để khai thác tối đa sức mạnh mà njs mang lại.

Cấu hình Nginx JavaScript (njs) nâng cao để xử lý logic định tuyến phức tạp ngay tại tầng Web Server | DPTCloud