NGINX: Hướng dẫn sử dụng Lua trên Alpine

NGINX với module Lua là một giải pháp mạnh mẽ để mở rộng khả năng của NGINX bằng cách sử dụng ngôn ngữ lập trình Lua. Lua thường được dùng để xử lý logic tùy chỉnh, tương tác với backend, hoặc thực hiện các tác vụ xử lý phức tạp ngay trong NGINX.

Tài liệu tham khảo

# NGINX Documentation
- [Lua](https://docs.nginx.com/nginx/admin-guide/dynamic-modules/lua/)
- [NGINX Lua Module Reference](https://github.com/openresty/lua-nginx-module)

# Docker Hub:
- [nqdev/nginx](https://hub.docker.com/r/nqdev/nginx)

---

1. Cài Đặt NGINX và Lua Trên Alpine Linux

Bước 1: Cài Đặt Alpine

Đảm bảo bạn đã cài đặt Alpine Linux. Nếu đang sử dụng Docker, bạn có thể bắt đầu với hình ảnh Alpine:

docker pull alpine

Bước 2: Cài Đặt Các Gói Cần Thiết

Cài đặt NGINX, Lua và các công cụ cần thiết:

apk add nginx lua5.3 lua5.3-dev luarocks gcc make musl-dev

Bước 3: Cài Đặt Module Lua-nginx

Sử dụng luarocks để cài đặt module Lua-nginx:

luarocks install lua-nginx-module

Bước 4: Biên Dịch NGINX Với Lua-nginx

Nếu bạn muốn sử dụng Lua-nginx như một module động, bạn cần biên dịch NGINX:

wget http://nginx.org/download/nginx-<version>.tar.gz
wget https://github.com/openresty/lua-nginx-module/archive/refs/heads/master.zip
tar -xzvf nginx-<version>.tar.gz
unzip master.zip
cd nginx-<version>
./configure --add-module=../lua-nginx-module-master
make && make install

---

2. Cấu Hình NGINX Sử Dụng Lua

Thêm Lua Vào nginx.conf

Trong file nginx.conf, bạn có thể gọi các tập lệnh Lua bằng cách sử dụng các chỉ thị như content_by_lua hoặc access_by_lua.

Ví Dụ: Hello World Với Lua

Thêm đoạn cấu hình sau vào nginx.conf:

server {
    listen 80;

    location /hello {
        content_by_lua_block {
            ngx.say("Hello, Lua in NGINX!")
        }
    }
}

Khởi Chạy Lại NGINX

Kiểm tra và khởi chạy lại NGINX:

nginx -t
nginx -s reload

Mở trình duyệt và truy cập http://localhost/hello để thấy kết quả.

---

3. Các Ứng Dụng Lua Trong NGINX

Xử Lý Request

Sử dụng Lua để phân tích dữ liệu request và thực hiện các tác vụ tùy chỉnh:

location /inspect {
    content_by_lua_block {
        local headers = ngx.req.get_headers()
        for k, v in pairs(headers) do
            ngx.say(k, ": ", v)
        end
    }
}

Gửi Request Tới Backend

Lua có thể sử dụng thư viện resty.http để gửi request HTTP:

location /proxy {
    content_by_lua_block {
        local http = require("resty.http")
        local httpc = http.new()
        local res, err = httpc:request_uri("http://example.com", {
            method = "GET"
        })
        if not res then
            ngx.say("Failed to request: ", err)
            return
        end
        ngx.say(res.body)
    }
}

Xử Lý Dữ Liệu JSON

Sử dụng thư viện cjson để xử lý JSON:

location /json {
    content_by_lua_block {
        local cjson = require("cjson")
        local data = {
            message = "Hello, Lua with JSON!",
            status = "success"
        }
        ngx.say(cjson.encode(data))
    }
}

---

4. Tối Ưu Lua Trong NGINX

• Sử Dụng LuaJIT: LuaJIT là trình biên dịch Just-In-Time cho Lua, giúp cải thiện hiệu năng đáng kể. Cài đặt LuaJIT trên Alpine:

• apk add luajit luajit-dev

• Tối Ưu Bộ Nhớ: Hạn chế sử dụng biến cục bộ lớn và xóa biến không cần thiết để giảm tải bộ nhớ.

• Thư Viện OpenResty: Tận dụng các thư viện OpenResty như resty.core, resty.redis để xử lý nhanh và hiệu quả.

---

5. Kiểm Tra Kết Quả

Sau khi cấu hình, sử dụng curl để kiểm tra các endpoint Lua:

curl http://localhost/hello
curl http://localhost/inspect
curl http://localhost/proxy
curl http://localhost/json

---

Kết Luận

Sử dụng Lua trong NGINX trên Alpine Linux là một cách tiếp cận linh hoạt để mở rộng và tùy chỉnh chức năng của NGINX. Với Lua, bạn có thể tích hợp các logic phức tạp mà không cần phụ thuộc hoàn toàn vào backend, giúp giảm tải và cải thiện hiệu suất.