Mục lục#
1. Tổng quan Kiến trúc#
Traffic Tools là hệ thống traffic automation được xây dựng theo mô hình Microservice, bao gồm 3 thành phần chính giao tiếp với nhau qua HTTP Webhook:┌─────────────────────────────────────────────────────────────────────┐
│ TRAFFIC TOOLS ECOSYSTEM v2.5 │
│ │
│ ┌──────────────┐ REST API ┌────────────────┐ Webhooks │
│ │ Admin UI │ ──────────── │ API (Go) │ ←──────────────── │
│ │ (Vue 3) │ │ Port: 33001 │ │
│ │ Port: 5173 │ └───────┬────────┘ │
│ └──────────────┘ │ Webhook │
│ │ (HTTP POST) │
│ ▼ │
│ ┌──────────────────┐ │
│ │ Tools V2 │ │
│ │ (Bun/ElysiaJS) │ │
│ │ Port: 3005 │ │
│ │ Puppeteer │ │
│ └──────────────────┘ │
└─────────────────────────────────────────────────────────────────────┘
Vai trò từng thành phần#
| Thành phần | Công nghệ | Vai trò |
|---|
| Admin | Vue 3 + Vite + Naive UI | UI quản lý chiến dịch, dự án, proxy, báo cáo |
| API | Golang + GoFiber + GORM | Backend trung tâm: điều phối Task, quản lý DB, Cron |
| Tools V2 | Bun + ElysiaJS + Puppeteer | Worker thực thi: chạy Browser, click traffic, report |
2. Các thành phần#
2.1 Admin — Giao diện quản lý (Vue 3)#
admin/
├── src/
│ ├── views/ # Màn hình: Dashboard, Campaigns, Projects, Proxy...
│ ├── components/ # UI components tái sử dụng
│ ├── stores/ # Pinia state management
│ ├── services/ # API client (Axios)
│ ├── router/ # Vue Router
│ ├── composables/ # Composition API hooks
│ └── layouts/ # Layout wrapper
Naive UI component library
ECharts / Charts data visualization
API (Go) qua VITE_API_SERVER.
2.2 API — Backend trung tâm (Golang)#
api/
├── internal/
│ ├── user/ # Quản lý tài khoản
│ ├── campaign/ # Chiến dịch traffic
│ ├── project/ # Dự án / Domain target
│ ├── project_detail/ # Thống kê hàng giờ
│ ├── proxy/ # Quản lý Proxy pool
│ ├── task/ # Task traffic (MongoDB)
│ ├── keyword/ # Từ khóa tracking SERP
│ ├── server/ # Worker server registry
│ ├── profiles/ # Google account profiles
│ └── ...
├── deploy/ # Docker configs
└── docker-compose.yaml
GoFiber v2 HTTP framework (tốc độ cao)
mongo-driver MongoDB driver
| DB | Port | Mục đích |
|---|
| MySQL 8.4 | 33022 | Dữ liệu nghiệp vụ: users, campaigns, projects, servers |
| MongoDB 8 | 33021 | Tasks, proxies, profiles, keywords, results |
| Redis 6.2 | 33023 | Session cache, rate limiting, pub/sub |
tools_v2/
├── src/
│ ├── api/ # HTTP API Controllers
│ │ ├── task/ # Task CRUD + query
│ │ ├── task-group/ # TaskGroup management + cron
│ │ ├── proxy/ # Proxy management + cron
│ │ ├── search/ # SERP search + cron
│ │ ├── report-tasks/ # Report campaign + cron
│ │ ├── monitor/ # System monitoring
│ │ ├── screenshot/ # Screenshot endpoints
│ │ └── test/ # Test proxy/profile
│ ├── services/ # Business logic services
│ │ ├── ads/ # Ads click service
│ │ ├── ai/ # GPT integration
│ │ ├── browser/ # Browser session management
│ │ ├── captcha/ # CAPTCHA handling
│ │ ├── email/ # Email sending (SMTP)
│ │ ├── proxy/ # Proxy rotation
│ │ ├── search/ # SERP scraping
│ │ ├── report-tasks/ # Report execution
│ │ ├── profiles/ # Google account management
│ │ ├── screenshot/ # Screenshot capture
│ │ ├── storage/ # DigitalOcean Spaces
│ │ ├── webhook/ # Webhook callbacks
│ │ └── zing-proxy/ # ZingProxy provider
│ ├── utils/
│ │ ├── browser_manager.ts # Puppeteer pool manager
│ │ ├── env.ts # Config centralization
│ │ ├── logger.ts # Logging system
│ │ └── ip-validation.middleware.ts
│ └── config/
│ └── database/mongodb.config.ts
Bun runtime (Node.js alternative, nhanh hơn ~3x)
ElysiaJS HTTP framework (type-safe, performance)
Puppeteer headless Chrome automation
Typegoose + Mongoose MongoDB ODM
@elysiajs/cron scheduled jobs
3. Sơ đồ kiến trúc tổng thể#
┌─────────────────────────────────────────────────────────────────────────────────┐
│ EXTERNAL WORLD │
│ │
│ Browser User ──► Admin UI (Vue 3) :5173 │
│ │ │
│ │ REST/JWT │
│ ▼ │
│ ┌───────────────────────────────────────────────────────────────────────────┐ │
│ │ API SERVICE (Golang) :33001 │ │
│ │ │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │ /user │ │/campaign │ │ /project │ │ /proxy │ │ /task │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │
│ │ │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │/keyword │ │ /server │ │/profiles │ │/webhook │ │ /report │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │
│ │ │ │
│ │ ┌────────────────────────────────────────────────────────────────────┐ │ │
│ │ │ CRON SCHEDULER (API) │ │ │
│ │ │ • */5m → Send Tasks to Workers │ │ │
│ │ │ • */10m → Search Keyword SERP │ │ │
│ │ │ • */5m → Check Project Dead │ │ │
│ │ │ • 0 0 * → Reset Tasks, Report Traffic, Monthly/Weekly report │ │ │
│ │ │ • */10m → Change Active Proxy, Rotate Proxy │ │ │
│ │ └────────────────────────────────────────────────────────────────────┘ │ │
│ └──────┬────────────────────────────────────────────────────┬────────────────┘ │
│ │ │ │
│ │ Webhook POST │ Webhook POST │
│ │ (Task Assignment) │ (Results/Stats) │
│ ▼ ▲ │
│ ┌─────────────────────────────────────────────────────────────────────────────┐ │
│ │ TOOLS V2 WORKER (Bun/ElysiaJS) :3005 │ │
│ │ │ │
│ │ ┌─────────────────┐ ┌──────────────────┐ ┌────────────────────────┐ │ │
│ │ │ Task Group Cron │ │ Proxy Cron │ │ Report Task Cron │ │ │
│ │ │ (every second) │ │ (every second) │ │ (every 5s SERP/30s) │ │ │
│ │ └────────┬─────────┘ └──────────────────┘ └────────────────────────┘ │ │
│ │ │ │ │
│ │ ▼ │ │
│ │ ┌──────────────────────────────────────────────────────────────────────┐ │ │
│ │ │ BROWSER MANAGER (Puppeteer Pool) │ │ │
│ │ │ Max: 100 browsers │ Per-process: 1-N │ Anti-detect: UA, GPS... │ │ │
│ │ └──────────────────────────────────────────────────────────────────────┘ │ │
│ │ │ │ │
│ │ ┌────────┼──────────────────────────────────────────────────────────────┐ │ │
│ │ │ │ Execution Flows │ │ │
│ │ │ ┌─────▼─────────┐ ┌───────────────┐ ┌──────────────────────────┐ │ │ │
│ │ │ │ Traffic Flow │ │ Search Flow │ │ Report Task Flow │ │ │ │
│ │ │ │ Direct/Organic│ │ SERP Scrape │ │ Browser/Email Report │ │ │ │
│ │ │ │ Ads Click │ │ Result Parse │ │ GPT Content Gen │ │ │ │
│ │ │ │ Kill Traffic │ │ Webhook Send │ │ Screenshot Evidence │ │ │ │
│ │ │ └───────────────┘ └───────────────┘ └──────────────────────────┘ │ │ │
│ │ └────────────────────────────────────────────────────────────────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────────────┐ │
│ │ DATABASE LAYER │ │
│ │ MongoDB :33021 MySQL :33022 Redis :33023 │ │
│ │ (Tasks, Proxies, (Users, Campaigns, (Sessions, Cache, │ │
│ │ Profiles, Keywords) Projects, Servers) Rate Limit) │ │
│ └─────────────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────────────┐ │
│ │ EXTERNAL SERVICES │ │
│ │ ZingProxy API │ OpenAI GPT API │ DigitalOcean Spaces │ │
│ │ (Proxy Rotation) │ (Report Content) │ (Screenshot Storage) │ │
│ │ │ │ │ │
│ │ Telegram Bot │ SMTP Gmail │ CocCoc Token │ │
│ │ (Notifications) │ (Email Reports) │ (Ads automation) │ │
│ └─────────────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────────┘
4. Luồng Traffic (Traffic Flow)#
Đây là luồng chính của hệ thống — tự động hóa lượt truy cập vào Website target.STEP 1: Admin tạo Project
───────────────────────────
Admin UI → API → MySQL (projects table)
• Khai báo: Domain đích, search keyword, device, engine, traffic type
• Đặt thời gian chạy (time_frame), thời gian đọc trang (page_view)
STEP 2: API Cron gửi Tasks (*/5 phút)
───────────────────────────────────────
API Cron: SCHEDULE_SEND_TASK=*/5 * * * *
├── Đọc danh sách Projects active từ MySQL
├── Tính số lượt cần chạy trong frame giờ này
├── Tạo TaskGroup objects
└── POST → Tools V2 API: /api/task-groups/create-multiple
Body: { tasks: [...], proxy_webhook: "...", webhook_url: "..." }
STEP 3: Tools V2 nhận Tasks
──────────────────────────────
Tools V2 /api/task-groups/create-multiple:
├── Validate request (IP whitelist, API key)
├── Lưu TaskGroups vào MongoDB (status=PENDING)
└── Trả về 200 OK
STEP 4: Cron xử lý TaskGroup (mỗi giây)
─────────────────────────────────────────
cronTaskGroup.start() [EVERY_SECOND]:
├── Query MongoDB: task_groups WHERE status=PENDING LIMIT 25
├── Với mỗi group:
│ ├── Set status=PROCESSING
│ ├── Request Proxy từ API (GET proxy_webhook)
│ ├── Launch Puppeteer Browser session
│ └── Execute Traffic Flow:
│ ├── [DIRECT] → Mở URL trực tiếp
│ └── [ORGANIC] → Mở Google → Tìm keyword
│ → Tìm URL trong kết quả
│ → Click (organic / ads / kill)
│
└── Sau khi chạy xong:
├── Cập nhật Task result (result_status, rank, ip_public...)
├── POST kết quả → webhook_url (API)
└── Set TaskGroup status=COMPLETED
STEP 5: API nhận kết quả Webhook
──────────────────────────────────
API nhận POST tại WEBHOOK_TASK_UPDATE_STATUS_URL:
├── Cập nhật Task result trong MongoDB
├── Cập nhật project_details (total_success/fail cho giờ này)
└── Cập nhật server_hourly_reports
Chi tiết các loại Traffic#
┌────────────────────────────────────────────────────────────┐
│ TRAFFIC TYPES │
│ │
│ DIRECT Traffic │
│ ══════════════ │
│ Browser → Mở URL thẳng → Đọc trang (time_min~time_max) │
│ → Scroll trang → Đóng │
│ │
│ ORGANIC Traffic (Home/Natural) │
│ ══════════════════════════════ │
│ Browser → Google.vn/Google/CocCoc │
│ → Nhập search_keyword │
│ → Tìm URL đích trong kết quả tự nhiên │
│ → Click → Đọc trang (time_min~time_max) │
│ → Navigate các trang nội bộ │
│ │
│ ORGANIC + only_ads=true (Ads Click) │
│ ══════════════════════════════════ │
│ Browser → Google → Nhập keyword │
│ → Tìm Quảng Cáo (ads) của domain đích │
│ → Click quảng cáo → Đọc trang │
│ │
│ ORGANIC + is_kill=true (Kill Traffic / Click Fraud) │
│ ════════════════════════════════════════════════ │
│ Browser → Google → Nhập keyword │
│ → Tìm Quảng Cáo của Domain ĐỊCH (competitor) │
│ → Click ads địch → KHÔNG đọc (thoát ngay) │
│ → Mục đích: tiêu cạn ngân sách quảng cáo địch │
└────────────────────────────────────────────────────────────┘
5. Luồng Search / SERP#
Luồng cào kết quả tìm kiếm để theo dõi thứ hạng từ khóa.STEP 1: API Cron quét Keyword (*/10 phút)
──────────────────────────────────────────
SCHEDULE_SEARCH_KEYWORD=*/10 * * * *
├── Đọc danh sách Keywords từ MongoDB (status=ENABLE)
├── Với mỗi keyword + engine + device:
│ └── POST → Tools V2: /api/search/create
│ Body: { keyword, engine, device, result_num, proxy_url, webhook_url }
STEP 2: Tools V2 xử lý Search Task (Cron 30s)
───────────────────────────────────────────────
searchCron:
├── Query MongoDB: search WHERE status=PENDING
├── Launch Puppeteer → Mở Google/CocCoc
├── Nhập keyword → Chờ kết quả
├── Parse kết quả:
│ ├── ads[]: { url, rank } ← Quảng cáo
│ └── search[]: { url, rank } ← Kết quả tự nhiên
├── Lưu search_data vào MongoDB
└── POST kết quả → web_hook_url (API)
Body: { keyword_id, search_data: { ads, search } }
STEP 3: API cập nhật thứ hạng dự án
──────────────────────────────────────
API nhận webhook → So sánh domain dự án với SERP results
→ Cập nhật project_details.rank
→ Gửi Telegram notification nếu có thay đổi
6. Luồng Report Task#
Tự động báo cáo domain vi phạm lên các tổ chức bảo mật (116+ platforms).STEP 1: Tạo Report Task
────────────────────────
Admin UI / API → POST /api/report-tasks/create
• Domain cần report, platform, report_type
• Hệ thống tạo unique_key để chống trùng
• Set scheduled_for (có spacing giữa các task)
STEP 2: Worker xử lý Report (Cron 5s)
───────────────────────────────────────
reportTaskCron [every 5 seconds]:
├── Query: report_tasks WHERE status=PENDING & scheduled_for <= now
├── Sort by priority DESC
├── Với mỗi task:
│ ├── Lấy Proxy (từ proxy_url webhook)
│ ├── Lấy Profile (từ profile_url webhook)
│ └── Phân loại report_type:
│ │
│ ├── BROWSER_BASED:
│ │ ├── Launch Puppeteer với Proxy
│ │ ├── Mở URL form báo cáo
│ │ ├── Điền thông tin tự động
│ │ ├── Submit form
│ │ └── Chụp screenshot làm bằng chứng
│ │
│ └── EMAIL_BASED:
│ ├── Load Profile Google account
│ ├── GPT sinh nội dung email report
│ ├── Gửi email qua SMTP/OAuth2
│ └── Ghi kết quả emailResults[]
STEP 3: Ghi kết quả & Callback
────────────────────────────────
├── Lưu result vào report_tasks.result
├── Upload screenshot lên DigitalOcean Spaces
├── POST callback → webhook_url (API)
│ Body: { task_id, success, platform, ... }
└── Retry nếu thất bại (max_retries=3)
7. Hệ thống Proxy#
┌────────────────────────────────────────────────────────────────────┐
│ PROXY ARCHITECTURE │
│ │
│ PROVIDERS (External) │
│ ───────────────────── │
│ ZingProxy API ──────┐ │
│ Enode API ──────────┼──► proxy_providers (MongoDB) │
│ M2Proxy API ────────┘ └── proxy_packages │
│ └── proxies │
│ │
│ ROTATION FLOW (API Cron: */10 phút) │
│ ─────────────────────────────────── │
│ 1. Cron chạy SCHEDULE_CHANGE_ACTIVE_PROXY │
│ 2. Gọi API nhà cung cấp (rotate_url) │
│ 3. Nhận IP Public mới │
│ 4. Cập nhật proxy.ip_public + proxy_ip_logs │
│ 5. Ghi lịch sử xoay │
│ │
│ ASSIGNMENT FLOW (khi Worker cần Proxy) │
│ ────────────────────────────────────── │
│ Tools V2 Worker → GET API: /api/proxy/get?domain=xxx │
│ API logic: │
│ ├── Tìm Proxy phù hợp (area, is_active, not_domain_blocked) │
│ ├── Kiểm tra domain_blocks │
│ ├── Increment proxy.in_use │
│ └── Trả về proxy credentials │
│ │
│ PROXY HEALTH │
│ ──────────── │
│ error_count >= threshold → is_active = false │
│ is_captcha = true → excluded từ pool │
│ expired_at < now → excluded │
│ │
│ PROXY POOLS │
│ ──────────── │
│ api.proxies (MongoDB) → Paid rotating proxies (main pool) │
│ tools_v2.proxies → Worker-local proxy cache │
│ backup_proxies → Dự phòng khi main lỗi │
│ free_proxies → Free public proxies (GitHub sources) │
└────────────────────────────────────────────────────────────────────┘
8. Hệ thống Cron Jobs#
API Cron Jobs (Golang)#
| Cron | Schedule | Mô tả |
|---|
SCHEDULE_SEND_TASK | */5 * * * * | Gửi Task xuống Worker (mỗi 5 phút) |
SCHEDULE_SEARCH_KEYWORD | */10 * * * * | Quét thứ hạng từ khóa SERP |
SCHEDULE_CHECK_PROJECT_DEAD | */5 * * * * | Kiểm tra Project chết (không có kết quả 30 phút) |
SCHEDULE_CHANGE_ACTIVE_PROXY | */10 * * * * | Xoay IP Proxy định kỳ |
SCHEDULE_SERVER_HOURLY_REPORT | 0 * * * * | Ghi báo cáo theo giờ mỗi Server |
SCHEDULE_CONFIRM_FIRE | */30 * * * * | Xác nhận chiến dịch "fire" ads |
SCHEDULE_RESET_TASK | 0 0 * * * | Reset Task về Pending (0h mỗi ngày) |
SCHEDULE_REPORT_PROXY_EXPIRED | 0 0 * * * | Báo cáo Proxy sắp hết hạn |
SCHEDULE_REPORT_TRAFFIC | 0 0 * * * | Tổng hợp traffic report hàng ngày |
SCHEDULE_WEEKLY_REPORT | 0 0 * * 0 | Report tuần (Chủ Nhật) |
SCHEDULE_MONTHLY_REPORT | 0 0 1 * * | Report tháng (ngày 1) |
| Cron | Schedule | Mô tả |
|---|
task-group-cron-direct | EVERY_SECOND | Xử lý TaskGroup PENDING |
task-group-api-request-cron | EVERY_SECOND | Kéo Task mới từ API |
proxy-cron-direct | EVERY_SECOND | Xử lý Proxy queue |
proxy-cron-webhook-direct | EVERY_SECOND | Gửi Webhook Proxy kết quả |
task-group-cleanup-cron | 30 0 * * * (0:30 AM) | Dọn task_groups cũ |
search-cron | Configurable (CRON_SEARCH_LIMIT=1) | Chạy SERP search |
webhook-search-cron | Configurable | Gửi kết quả SERP về API |
report-task-cron | Every 5s | Thực thi Report Task |
report-task-request-cron | Every 30s | Kéo Report Task mới từ API |
9. Giao tiếp giữa các dịch vụ#
9.1 Admin → API#
Giao thức: HTTPS REST API
Auth: JWT Bearer Token
Endpoints chính:
POST /api/auth/login → Đăng nhập, nhận JWT
GET /api/campaigns → Danh sách chiến dịch
POST /api/projects → Tạo dự án mới
GET /api/proxy → Danh sách Proxy
GET /api/dashboard → Thống kê tổng hợp
GET /api/report → Báo cáo traffic
Giao thức: HTTP POST Webhook
Auth: WEBHOOK_KEY (trong request body hoặc header)
IP Whitelist: WHITE_LIST_IP_TOOL_TRAFFIC
API → Tools V2:
POST /api/task-groups/create-multiple
Header: X-Webhook-Key: <WEBHOOK_KEY>
Body: {
"tasks": [
{
"id": "task-123",
"project_id": 456,
"proxy_url": "https://api.example.com/api/proxy/get",
"webhook_url": "https://api.example.com/api/task/update-status",
"traffic_type": { "method": 1, "search_keyword": "...", ... },
"page_view": [{ "time_min": 30, "time_max": 120 }],
"traffic_device": 0
}
],
"proxy_webhook": "https://api.example.com/api/proxy/get"
}
Giao thức: HTTP POST Webhook
Auth: WEBHOOK_KEY
Tools V2 → API (Task result):
POST /api/task/update-status
Body: {
"task_id": "task-123",
"result_status": 1,
"rank": 3,
"ip_public": "1.2.3.4",
"execution_time": 45000,
"user_agent": "Mozilla/5.0..."
}
Tools V2 → API (Proxy get):
GET /api/proxy/get?domain=example.com
Response: { "ip": "...", "port": 8080, "username": "...", "password": "..." }
Tools V2 → API (Search result):
POST /api/keyword/search
Body: {
"keyword_id": "abc123",
"search_data": {
"ads": [{ "url": "https://...", "rank": 1 }],
"search": [{ "url": "https://...", "rank": 3 }]
}
}
9.4 API → Telegram (Notifications)#
Giao thức: Telegram Bot API
Channels:
• TELEGRAM_CHAT_ID → Thông báo chung
• TELEGRAM_CHAT_ERROR_ID → Thông báo lỗi hệ thống
• TELEGRAM_CHAT_REPORT_ID → Báo cáo traffic định kỳ
Triggers:
• Project chuyển sang state "Dead"
• Proxy hết hạn
• Báo cáo tuần/tháng
• Lỗi nghiêm trọng
10. Bảo mật#
Authentication & Authorization#
┌──────────────────────────────────────────────────────────────────┐
│ SECURITY LAYERS │
│ │
│ Layer 1: JWT Authentication (Admin → API) │
│ ───────────────────────────────────────── │
│ • JWT_SECRET bảo vệ token │
│ • SESSION_TIMEOUT=1h │
│ • Roles: admin (0), user (1) │
│ • 2FA TOTP (Google Authenticator) │
│ │
│ Layer 2: Webhook Authentication (API ↔ Tools V2) │
│ ───────────────────────────────────────────────── │
│ • WEBHOOK_KEY phải khớp giữa API và Tools V2 │
│ • WEBHOOK_SECKET_KEY cho proxy operations │
│ • IP Whitelist: WHITE_LIST_IP_TOOL_TRAFFIC │
│ │
│ Layer 3: IP Allowlist (Tools V2) │
│ ───────────────────────────────── │
│ • IP_ALLOWED=[list] → chỉ IPs trong list được gọi API │
│ • ipValidationMiddleware kiểm tra mọi request │
│ │
│ Layer 4: API Key (Internal Services) │
│ ──────────────────────────────────── │
│ • API_KEY cho các service internal │
│ • PROXY_API_KEY cho proxy operations │
│ • ZING_PROXY_API_KEY cho external proxy provider │
└──────────────────────────────────────────────────────────────────┘
Anti-Detection (Browser Automation)#
Puppeteer được cấu hình để tránh phát hiện bot:
• Randomized User-Agent (Desktop/Mobile/OS khác nhau)
• Randomized Geolocation (± 2km từ tọa độ thật)
• Human-like scroll behavior
• Random dwell time (time_min ~ time_max giây)
• Proxy rotation per session
• Profile fingerprint persistence
• CAPTCHA detection + graceful exit
11. Lưu trữ & File Storage#
DigitalOcean Spaces (S3-compatible)#
Cấu hình:
DIGITALOCEAN_BUCKET_NAME=bucket-name
DIGITALOCEAN_REGION=nyc3
DIGITALOCEAN_ENDPOINT=https://nyc3.digitaloceanspaces.com
DIGITALOCEAN_CDN_URL=https://bucket.nyc3.cdn.digitaloceanspaces.com
Dùng cho:
• Screenshot bằng chứng (report_tasks.screenshotUrl)
• Evidence images/videos
File naming:
screenshots/{date}/{task_id}.png
Log File System#
Tools V2 local logs: storage/log/
├── app/ → General application logs
├── browser_manager/ → Puppeteer session logs
├── task/ → Task execution logs
└── error/ → Error logs
Cấu hình:
LOG_LEVEL=info|debug|warn|error
LOG_WRITE_TO_FILE=true
LOG_WRITE_TO_CONSOLE=true
LOG_DIR=storage/log
12. Network Topology#
Docker Network#
Network: traffic_tool_network (Bridge)
Subnet: 11.0.3.0/24
Gateway: 11.0.3.1
Services:
traffic_tool_api → 11.0.3.x:33001
traffic_tool_mongodb → 11.0.3.x:27017 (expose: 33021)
traffic_tool_mysql → 11.0.3.x:3306 (expose: 33022)
traffic_tool_redis → 11.0.3.x:6379 (expose: 33023)
Tools V2 → runs separately (giao tiếp qua API_HOST)
Admin → runs on host (VITE_API_SERVER=http://...)
Port Map (Production)#
| Service | Internal Port | External Port | Protocol |
|---|
| API (Go) | 33001 | 33001 | HTTP/HTTPS |
| API Debug | 2345 | 33013 | TCP (Delve) |
| MongoDB | 27017 | 33021 | MongoDB |
| MySQL | 3306 | 33022 | MySQL |
| Redis | 6379 | 33023 | Redis |
| Tools V2 | 3005 | 3005 | HTTP |
| Admin UI | 5173 | 5173 | HTTP (dev) |
Deployment Flow#
Production Setup:
┌─────────────────────────────────┐
Internet │ Server Machine │
───────── │ │
Browser ──► Nginx/CF ──►│ Admin :443/80 → Vite static │
│ API :33001 → Go binary │
│ V2 :3005 → Bun runtime │
│ │
│ Docker containers: │
│ MongoDB :33021 │
│ MySQL :33022 │
│ Redis :33023 │
└─────────────────────────────────┘
Modified at 2026-03-25 07:00:46
