nqdev/nginx

ViHAT's customized version of NGINX includes additional useful modules for usage.

NGINX Enhanced Docker Image

Tổng quan

Docker image này được xây dựng dựa trên nginx:1.27.2-alpine và được mở rộng với các module tuỳ chỉnh, đồng thời tích hợp thêm các tính năng mới nhằm tối ưu việc cấu hình và sử dụng.

Điểm mới trong Dockerfile:

• Hỗ trợ LuaJIT và Lua scripting: Cho phép chạy các đoạn mã Lua trong NGINX với hiệu suất cao.

• Bổ sung các module mới:

  • ngx_http_headers_more_filter_module: Kiểm soát và tuỳ chỉnh HTTP headers.

  • ngx_http_geoip_module: Thêm khả năng truy vấn địa chỉ IP và định vị địa lý.

  • ngx_http_rate_limit_module: Quản lý giới hạn tốc độ truy cập.

  • Backup tự động và Cron Jobs: Hỗ trợ sao lưu định kỳ file cấu hình NGINX.

• Thêm tập lệnh build động: Cho phép biên dịch và thêm module tuỳ chỉnh.

Danh sách các module có thể sử dụng trong phiên bản image này:

• ngx_http_geoip_module-debug.so

• ngx_http_geoip_module.so

• ngx_http_headers_more_filter_module.so

• ngx_http_image_filter_module-debug.so

• ngx_http_image_filter_module.so

• ngx_http_js_module-debug.so

• ngx_http_js_module.so

• ngx_http_rate_limit_module.so

• ngx_http_xslt_filter_module-debug.so

• ngx_http_xslt_filter_module.so

• ngx_mail_module.so

• ngx_stream_geoip_module-debug.so

• ngx_stream_geoip_module.so

• ngx_stream_js_module-debug.so

• ngx_stream_js_module.so

Các mô-đun này được đặt trong thư mục /usr/lib/nginx/modules/.

Tính năng chính

1. Base Image: Dựa trên Alpine Linux - gọn nhẹ và nhanh chóng.

2. LuaJIT:

   • Tích hợp LuaJIT để chạy mã Lua trong NGINX.

   • Dùng để xử lý các request và response linh hoạt hơn.

3. Headers More:

   • Cấu hình và loại bỏ HTTP headers dễ dàng.

4. Backup cấu hình tự động:

   • Cron Jobs thực thi backup hàng tuần các file cấu hình NGINX.

   • Backup lưu tại /var/backups/nginx_config.

---

Hướng dẫn sử dụng

1. Kéo Image

docker push nqdev/nginx:<tag>

2. Chạy Container

docker run -d -p 80:80 -p 443:443 --name my-nginx nqdev/nginx:<tag>

3. Tích hợp Lua Scripts

Để sử dụng Lua scripting:

• Mount file Lua vào container và tham chiếu trong nginx.conf:

location /api {
    content_by_lua_file /path/to/your/script.lua;
}

4. Tuỳ chỉnh HTTP Headers

Sử dụng Headers More để thêm hoặc xoá headers:

server {
    listen 80;
    location / {
        more_set_headers "X-Custom-Header: MyValue";
        more_clear_headers "Server";
    }
}

5. Backup file cấu hình NGINX

• Backup được tự động chạy hàng tuần bằng cron.

• Để thực hiện backup thủ công:

docker exec <container-id> /usr/local/bin/100-backup-nginx.sh

• Backup sẽ được lưu tại /var/backups/nginx_config.

---

Cổng mở

• 80: HTTP

• 443: HTTPS

• 8080: NGINX status page

---

Build Image tuỳ chỉnh

Dockerfile hỗ trợ build động và thêm các module khác:

1. Tạo Dockerfile của bạn:

FROM nqdev/nginx
COPY nginx.conf /etc/nginx/nginx.conf

1. Build Image:

docker build -t my-nginx-image .

---

Tham khảo

• LuaJIT: LuaJIT
• Headers More: headers-more-nginx-module
• Rate Limit: rate-limit-nginx-module

---

Liên hệ hỗ trợ

• Docker Community Slack
• Stack Overflow

---

Cách chạy nhanh

Ví dụ: Chạy NGINX với nội dung tĩnh

docker run --name static-nginx -v /local/content:/usr/share/nginx/html:ro -p 8080:80 my-nginx-image

Sau đó truy cập http://localhost:8080 để xem kết quả.