HƯỚNG DẪN SỬ DỤNG VÀ THIẾT LẬP: SEARCH TOOL

Tài liệu hướng dẫn Lập trình viên/Quản trị viên cách thiết lập môi trường và cấu hình hệ thống Search Tool (Worker).

I. YÊU CẦU MÔI TRƯỜNG (PREREQUISITES)

Để vận hành hệ thống, máy chủ vật lý hoặc môi trường cục bộ (Local) cần đáp ứng:

Bun: Phiên bản tối thiểu >= 1.2.5.

Node.js: Phiên bản 20+ (Bắt buộc do một số module cốt lõi của Puppeteer vẫn phụ thuộc môi trường Node).

Docker: Để khởi chạy CSDL MongoDB nội bộ.

Google Chrome: Phải được cài đặt trên hệ điều hành máy chủ (System-wide installation) do hệ thống sử dụng thư viện chrome-launcher.

II. QUY TRÌNH TRIỂN KHAI (DEPLOYMENT PROCESS)

Bước 1: Khởi tạo biến môi trường
Nhân bản tệp cấu hình mẫu tại thư mục gốc:

Bước 2: Khởi động Cơ sở dữ liệu
Chạy Container MongoDB thông qua tệp cấu hình Docker Compose có sẵn:

Bước 3: Tải thư viện và Khởi chạy
Sử dụng Bun để tải bộ phụ thuộc và khởi động máy chủ (có hỗ trợ Hot-Reload):

Máy chủ mặc định lắng nghe tại cổng 33033.

Bước 4: Kiểm tra trạng thái máy chủ
Gửi yêu cầu HTTP để xác nhận hệ thống vận hành ổn định:

III. CẤU HÌNH THAM SỐ QUAN TRỌNG (ENVIRONMENT CONFIGURATION)

Bảo mật: API_KEY (Khóa xác thực bảo vệ API nội bộ) và IP_ALLOWED (Danh sách IP Trắng được phép gọi lệnh).

Kiểm soát Tài nguyên Trình duyệt:

CRON_SEARCH_LIMIT: Giới hạn tác vụ tìm kiếm từ khóa chạy đồng thời (Mặc định: 10).

CRON_TASK_LIMIT: Giới hạn tác vụ xử lý Proxy chạy đồng thời (Mặc định: 14).

BROWSER_LIMIT: Số lượng luồng Chrome tối đa được phép mở. Phải được tinh chỉnh dựa trên dung lượng RAM của máy chủ thực tế (Ví dụ: 1 Chrome Tab tiêu tốn ~100MB RAM).

Cấu hình Giao tiếp (Webhook): GET_PROXY_API và WEBHOOK_API_KEY dùng để định tuyến và xác thực dữ liệu gửi về API Server.

User Guide

HƯỚNG DẪN SỬ DỤNG VÀ THIẾT LẬP: SEARCH TOOL#

I. YÊU CẦU MÔI TRƯỜNG (PREREQUISITES)#

II. QUY TRÌNH TRIỂN KHAI (DEPLOYMENT PROCESS)#

III. CẤU HÌNH THAM SỐ QUAN TRỌNG (ENVIRONMENT CONFIGURATION)#

HƯỚNG DẪN SỬ DỤNG VÀ THIẾT LẬP: SEARCH TOOL

I. YÊU CẦU MÔI TRƯỜNG (PREREQUISITES)

II. QUY TRÌNH TRIỂN KHAI (DEPLOYMENT PROCESS)

III. CẤU HÌNH THAM SỐ QUAN TRỌNG (ENVIRONMENT CONFIGURATION)