1. TOOL
Social Tool Documentation
  • Tổng quan
  • Bussiness | Logic
    • Bussiness | Logic
  • Project
    • ADMIN
      • Tổng quan ADMIN
      • Architecture
        • System architecture
        • Code structure
      • Deployment
        • Local
        • Staging
        • Product
      • Hướng dẫn sử dụng
        • Đăng nhập
        • FAQ
        • Mạng xã hội
          • Tài khoản mạng xã hội
          • Nội dung bài viết & bình luận
          • Quản lý liên kết
          • Thư viện hình ảnh
          • Thu thập dữ liệu
        • Hệ thống
          • Quản lý proxy
        • Chiến dịch
          • Tạo & quản lý chiến dịch
          • Đăng nhập tài khoản
          • Check Proxy
          • Join Group
    • API
      • Tổng quan API
      • Architecture
        • System architecture
        • Database schema
        • Code structure
      • Deployment
        • Local
        • Staging
        • Product
      • API Interface
        • 🔑 Identity & Session
          • List users
          • Create user
          • Update info user
          • Update info user
          • List user departments
          • Delete user
          • List user's AI keys
          • Create AI key
          • Get user's active API key
          • Get supported services
          • Get supported AI models
          • Update AI key
          • Delete AI key
          • Get AI key by ID
          • List departments
          • Create department
          • Update department
          • Create department
          • Update department
          • Update department roles
          • Get department roles
          • Update department status
          • Delete department
          • List user sessions
          • Create user session
          • Delete user session
          • Get user sessions by user ID
          • Delete all user sessions
          • Update user session status
          • List user activity logs
          • Create user activity log
          • Get user activity logs
          • Delete user activity logs
          • User login
          • User registration
          • User logout
          • Logout from all devices
          • Refresh access token
          • Create api key
          • Reset password
          • Get current user
          • Get user roles
          • Create role
          • Update role
          • Update role
          • Update role
          • List user permission groups
          • Get user permission group by ID
          • Delete user permission group
          • Create user permission group
          • Update user permission group
          • Get all user permission groups with permissions
        • 🛰️ Proxy & Connectivity
          • List proxies
          • Create proxy
          • Create many proxies
          • Update proxy
          • Delete proxy
          • Get proxy by ID
          • Import proxies from CSV/Excel
          • Check expired proxies
          • Kiểm tra proxy (qua Campaign)
          • Xóa proxy
          • Cập nhật proxy
          • Proxy Group list
          • Create a Proxy Group
          • Get a Proxy Group by ID
          • Update a Proxy Group
          • Delete a Proxy Group
          • Delete a Proxy Group
          • List proxy providers
          • Create proxy provider
          • Update proxy provider
          • Delete proxy provider
          • Get proxy provider by ID
          • Import proxy packages from CSV
          • List proxy packages
          • Create proxy package
          • Update proxy package
          • Delete proxy package
          • Get proxy package by ID
          • Import proxy packages from CSV
        • 📱 Social Management
          • List socials
          • Create social
          • Update social
          • Delete social
          • Get social by ID
          • List social accounts
          • Create social account
          • Create social account
          • Get account tasks
          • Assign proxies to social account
          • Update social account
          • Delete social account
          • Get social account by ID
          • Join social account
          • Cancel social accounts
          • Cancel social accounts
          • Import social accounts from file
          • Get account usage statistics
          • Push cookies manually for specific accounts (via Campaign)
          • Đổi tên nhiều tài khoản (qua Campaign)
          • Đổi mật khẩu nhiều tài khoản (qua Campaign)
          • Đổi ảnh đại diện (qua Campaign)
          • Social Account Group list
          • Create a Social Account Group
          • Get a Social Account Group by ID
          • Create a Social Account Group
          • Delete a Social Account Group
          • List social pages
          • Create social page
          • Update social page
          • Delete social page
          • Get social page by ID
          • Batch update social page status
          • Batch delete social pages
          • Import social pages from file
          • Search social pages
          • Batch delete social pages
          • Social Page Group list
          • Create a Social Page Group
          • Get a Social Page Group by ID
          • Update a Social Page Group
          • Delete a Social Page Group
          • List social actions
          • Create social action
          • Update social type
          • Delete social action
          • Get social type by ID
          • List social pages
          • Create social content
          • Update social content
          • Delete social content
          • Get social content by ID
          • Batch delete social content
          • Import social accounts from file
          • Create a new social content group
          • Get paginated list of social content groups
          • Get social content group by ID
          • Update social content group
          • Soft delete social content group
          • Batch delete social content groups
          • Delete social content group
          • Get groups by social platform ID
          • Social Image list
          • Create a Social Image
          • Get a Social Image by ID
          • Update a Social Image
          • Delete a Social Image
          • Social Collect Data list
          • Create a Social Collect Data
          • Get a Social Collect Data by ID
        • 📁 Campaign Management
          • List campaigns
          • Create campaign
          • Update campaign
          • Delete campaign
          • Get campaign by ID
          • Create campaign platform
          • List campaign platforms
          • Update campaign platform
          • Delete campaign platform
          • Get campaign platform by ID
          • Create campaign platform
          • Create campaign platform
          • Clone campaign platforms
          • Cancel multiple campaign platforms
          • List campaign joins
          • Create campaign platform
          • List campaign joins
          • Update campaign platform
          • Update campaign platform
          • Update campaign platform
          • Update campaign platform
          • List jobs
          • Update job
          • Delete job
          • Get job by ID
          • List campaign platform tasks
          • Create campaign platform task
          • Update campaign platform task
          • Delete campaign platform task
          • Get campaign platform job task by ID
          • List Report Categories
          • Create Report Categories
          • Create Report Categories
          • Create Report Categories
          • List Report Details
          • Create Report Details
          • Create Report Details
          • Create Report Details
    • TOOL
      • Tổng quan TOOL
      • Architecture
        • Database schema
        • System architecture
        • Code structure
      • Deployment
        • Local
        • Staging
        • Product
      • API Interface
        • 🎯 NATS — Task
          • [NATS RPC] Tạo batch Task mới
          • [NATS RPC] Lấy danh sách tất cả Tasks
          • [NATS RPC] Đếm số Task đang chờ xử lý
          • [NATS RPC] Xóa tất cả Tasks
        • 🍪 NATS — Cookie
          • [NATS RPC] Thêm batch Cookie (Auto Login)
          • [NATS RPC] Lấy danh sách tất cả Cookies
          • [NATS RPC] Xóa tất cả Cookies
        • 🌐 NATS — Proxy
          • [NATS RPC] Gửi batch Proxy để kiểm tra
        • 🔗 NATS — TaskJoin
          • [NATS RPC] Tạo lệnh tham gia Group
          • [NATS RPC] Kiểm tra trạng thái tham gia Group
        • 📤 NATS — Callbacks
          • [NATS PUB] Kết quả thực thi Task
          • [NATS PUB] Kết quả Crawl dữ liệu
          • [NATS PUB] Kết quả Auto Login
          • [NATS PUB] Kết quả kiểm tra Proxy
          • [NATS PUB] Kết quả tham gia Group
          • [NATS PUB] Kết quả kiểm tra trạng thái tham gia
        • 📊 HTTP — Logs & Info
          • Service Root — Thông tin Worker
          • Health Check
          • Đọc file log
          • Log hôm nay
          • Log theo ngày cụ thể
          • Danh sách ngày có log
          • Test kết nối ChatGPT
        • 📋 HTTP — Data Query
          • Danh sách Tasks (phân trang + lọc)
          • Xóa tất cả Tasks
          • Danh sách tất cả Cookies
          • Xóa tất cả Cookies
          • Xóa Cookie theo _id
          • Danh sách Proxies (lọc theo task_id)
          • Xóa tất cả Proxies
          • Proxy Checks đang chờ xử lý
          • Proxy Checks đã hoàn thành
          • Xóa Proxy theo _id
          • Danh sách Task Join (phân trang + lọc)
          • Tạo Task Join (HTTP mode)
          • Xóa tất cả Task Join
  • Schemas
    • AIInfo
    • CommentInfo
    • ReplyInfo
    • ShareInfo
    • CaptchaInfo
    • PageInfo
    • SocialAccountInfo
    • ProxyInfo
    • SocialInfo
    • ActionInfo
    • CreateTaskPayload
    • CreateCookiePayload
    • CreateProxyPayload
    • CreateTaskJoinPayload
    • NatsAcceptedResponse
    • NatsRejectedResponse
    • NatsErrorResponse
    • TaskCompletedPayload
    • CookieUpdatePayload
    • ProxyCheckResultPayload
    • TaskJoinResultPayload
    • TaskJoinCheckResultPayload
    • PagingInfo
    • AppError
  1. TOOL

Tổng quan TOOL

Social Tool Worker — Tổng quan hệ thống#

Tài liệu kỹ thuật – Phiên bản 1.0
Mô tả kiến trúc, chức năng và quy trình vận hành của Social Tool Worker

1. Giới thiệu#

Social Tool Worker là thành phần thực thi (Automation Worker) trong hệ thống Social Tool. Worker nhận lệnh từ API Server thông qua NATS Message Broker, sau đó sử dụng trình duyệt headless (Puppeteer + Google Chrome) để tự động thực hiện các hành động trên các nền tảng mạng xã hội.

Thông tin chung#

RuntimeBun (TypeScript)
FrameworkElysiaJS
DatabaseMongoDB + Typegoose ORM
Message BrokerNATS
Browser EnginePuppeteer + Google Chrome Stable
Port mặc định21033 (dev) / 51005 (prod)
Chế độ vận hànhNATS (event-driven) hoặc HTTP (REST API)

2. Giá trị cốt lõi#

Giá trịMô tả
🤖 Tự động hóa hoàn toànThực thi Like, Comment, Share, Post, Join Group, Login... mà không cần can thiệp thủ công
⚡ Phân bổ tài nguyên độngTự động phân chia worker giữa các module dựa trên khối lượng công việc thực tế
🔄 Hai chế độ vận hànhHỗ trợ cả NATS (event-driven, khuyên dùng) và HTTP (REST API)
🛡️ Proxy tích hợpMỗi tác vụ được route qua proxy riêng, bảo vệ tài khoản khỏi bị phát hiện
🧠 Tích hợp AISử dụng ChatGPT để sinh nội dung comment, reply thông minh
🔐 Captcha tự độngTích hợp dịch vụ giải captcha khi gặp rào cản bảo mật

3. Các module chức năng#

3.1. Task Module — Thực thi hành động MXH#

Module cốt lõi, xử lý các tác vụ tương tác trên mạng xã hội:
Hành độngMô tả
LikeThả cảm xúc bài viết
CommentBình luận (hỗ trợ AI sinh nội dung, đính kèm ảnh)
ReplyTrả lời comment (hỗ trợ AI, tối đa 5 reply/lượt)
ShareChia sẻ bài viết
PostĐăng bài mới (kèm ảnh)
Collect Data (Craw)Thu thập dữ liệu từ bài viết/trang
ReportBáo cáo bài viết
Rename / Change AvatarĐổi tên, đổi ảnh đại diện
Check Notification / NewFeedKiểm tra thông báo, bảng tin
Nền tảng hỗ trợ: Facebook, Instagram, Twitter, TikTok, Google, Telegram.

3.2. Cookie Module — Quản lý phiên đăng nhập#

Tự động đăng nhập vào tài khoản MXH, lấy cookie/session mới và thu thập thông tin profile (avatar, email, giới tính...).

3.3. Proxy Module — Kiểm tra proxy#

Xác minh proxy còn hoạt động hay không, phát hiện IP public thực tế, hỗ trợ auto-rotate IP.

3.4. TaskJoin Module — Tham gia nhóm#

Tự động tham gia hoặc kiểm tra trạng thái tham gia các Group (public/private) trên mạng xã hội.

4. Chế độ vận hành#

Worker hỗ trợ hai chế độ, được cấu hình qua biến môi trường USE_NATS:
NATS Mode (khuyên dùng)HTTP Mode
TriggerEvent-driven (subscribe NATS subjects)HTTP request từ API Server
WorkerPhân bổ tự động, tái cân bằng mỗi 120sKhông có cơ chế phân bổ
ScaleDễ scale ngang (thêm Worker node)Giới hạn bởi single instance
SwaggerKhông cóCó (/swagger)

5. Phân bổ Worker động (Dynamic Worker Allocation)#

Khi chạy ở chế độ NATS, hệ thống tự động phân bổ CRON_TASK_LIMIT worker cho các module dựa trên khối lượng công việc thực tế:
Ví dụ: Nếu CRON_TASK_LIMIT=4 và chỉ có module Task và Cookie có công việc, mỗi module sẽ nhận 2 worker. Khi module Proxy phát sinh công việc, hệ thống tự động tái phân bổ (ví dụ: Task=2, Cookie=1, Proxy=1).

6. Quy trình xử lý tác vụ#

[1] API Server tạo Task và gửi qua NATS
           │
           ▼
[2] Worker nhận Task, lưu vào MongoDB (status: PENDING)
           │
           ▼
[3] Cron quét task PENDING, chọn theo user_id
           │
           ▼
[4] Mở trình duyệt headless
    → Nạp Cookie + Proxy + User Agent
    → Truy cập URL mục tiêu
           │
           ▼
[5] Thực thi hành động (Like, Comment, Share...)
    → Xử lý Captcha nếu cần (tích hợp dịch vụ bên thứ ba)
    → Dùng AI sinh nội dung nếu được cấu hình
           │
           ▼
[6] Gửi kết quả về API Server qua NATS/Webhook
    → Cập nhật trạng thái: COMPLETED hoặc FAILED
    → Xóa task khỏi MongoDB (nếu DEBUG_DELETE_TASK_AFTER_PROCESSING=true)

7. Công nghệ sử dụng#

Thành phầnCông nghệMục đích
RuntimeBun ≥ 1.2.5JavaScript/TypeScript runtime nhanh
FrameworkElysiaJSHTTP server và routing
ORMTypegoose + MongooseTương tác MongoDB với TypeScript type-safe
DatabaseMongoDB ≥ 7Lưu trữ task queue, kết quả
MessagingNATSGiao tiếp bất đồng bộ với API Server
BrowserPuppeteer + puppeteer-extra-plugin-stealthTự động hóa trình duyệt, chống phát hiện bot
AIOpenAI (GPT-4o-mini)Sinh nội dung comment, reply
CaptchaOMO CaptchaGiải captcha tự động
LoggingCustom LoggerGhi log theo level, hỗ trợ file và console
ContainerDocker + SupervisorĐóng gói và quản lý tiến trình
Tài liệu được cập nhật lần cuối: 2026. Mọi thắc mắc vui lòng liên hệ đội ngũ kỹ thuật.
Modified at 2026-03-26 03:06:56
Previous
Create Report Details
Next
Database schema
Built with