1. Bussiness | Logic
Search Tool
  • Tổng quan
  • Bussiness | Logic
    • Nghiệp vụ & Luồng Tìm kiếm
    • Task Orchestration
    • Scraping & Execution
    • Exception & Recovery
    • Proxy Orchestration
  • Project
    • Search API
      • Tổng quan Search API
      • Architecture
        • Database Schema
        • System Architecture
        • Code Structure
      • API Interface
        • Go - Auth
          • Đăng nhập
          • Đăng ký (Public)
        • Go - User
          • Danh sách User (Phân trang)
          • Tạo User
          • Lấy tất cả User
          • Profile cá nhân
          • Chi tiết User
          • Cập nhật User
          • Xóa User
          • Đổi mật khẩu
        • Go - System
          • Nhật ký hoạt động (Phân trang)
          • Cập nhật dữ liệu Search
          • Test Webhook receiver
        • Go - Server
          • Danh sách Server (Phân trang)
          • Tạo Server
          • Lấy tất cả Server
          • Chi tiết Server
          • Cập nhật Server
          • Xóa Server
        • Go - Tasks
          • Tạo nhiều task Search
          • Lấy tất cả task Search
          • Reset trạng thái tất cả nhiệm vụ Search
          • Tạo nhiều task Anchor Text
          • Lấy tất cả nhiệm vụ Anchor Text
          • Reset trạng thái tất cả nhiệm vụ Anchor Text
        • Go - Webhook
          • Webhook cập nhật trạng thái (Dùng WEBHOOK_KEY)
          • Lấy Proxy cho Tool
          • Lấy Proxy có thể rotate
          • Cập nhật kết quả Search
          • Kết quả rotate Proxy
          • Cập nhật kết quả Anchor Text
          • Nhận kết quả từ Tool (v2)
      • Deployment
        • Local
        • Staging
        • Product
    • Search tool
      • Tổng quan Search Tool
      • Architecture
        • Database Schema
        • System Architecture
        • Code Structure
      • API Interface
        • Bun - Main
          • Thông tin server Bun
          • Health Check
          • Lấy file Log
        • Bun - Task
          • Danh sách Search Tasks
          • Tạo nhiều Search Tasks
          • Xóa tất cả Search Tasks
          • Xóa Search Task
          • Reset trạng thái Search
          • Reset running process
          • Danh sách Anchor Tasks
          • Tạo nhiều Anchor Tasks
          • Xóa tất cả Anchor Tasks
          • Xóa Anchor Task
          • Reset trạng thái Anchor
          • Reset running process
      • Deployment
        • Local
        • Staging
        • Product
  • Schemas
    • LoginRequest
    • ProxyRequest
    • CreateUserRequest
    • KeywordTaskRequest
    • UpdateUserRequest
    • SearchAutomationRequest
    • ChangePasswordRequest
    • CreateServerRequest
    • AnchorTextTaskRequest
  1. Bussiness | Logic

Proxy Orchestration

ĐẶC TẢ NGHIỆP VỤ: ĐIỀU PHỐI PROXY (PROXY ORCHESTRATION)#

Tài liệu quy định các ràng buộc logic liên quan đến việc cấp phát, xoay vòng và làm mới địa chỉ IP nhằm bảo vệ mạng lưới Worker khỏi các hệ thống tường lửa (Firewall/WAF).

1. Chu kỳ Xoay vòng (Proxy Rotation)#

Việc sử dụng một địa chỉ IP liên tục sẽ dẫn đến nguy cơ bị chặn truy cập vĩnh viễn.
Kích hoạt Xoay vòng: Worker tự động kích hoạt lệnh đổi IP sau khi hoàn thành một tác vụ nhất định hoặc khi thời gian tồn tại của IP hiện tại vượt quá cấu hình rotate_time.
Giải phóng Phiên (Session Release): Trong quá trình gọi lệnh đổi IP, Proxy sẽ tạm thời không khả dụng cho các tác vụ khác.

2. Ràng buộc Xác thực IP (IP Verification)#

Để ngăn chặn trường hợp hàm API của đối tác cung cấp Proxy báo thành công nhưng IP vật lý không thực sự thay đổi (Lỗi kỹ thuật từ phía nhà mạng).
Xác thực Độc lập: Sau khi hệ thống gọi lệnh đổi IP, thiết bị phải thực hiện một truy vấn HTTPS độc lập thông qua Proxy mới hướng đến dịch vụ kiểm tra IP (như api.ipify.org) để lấy địa chỉ Public IP.
Đối chiếu Dữ liệu: Nếu Public IP nhận về trùng khớp hoàn toàn với IP trước khi đổi, hệ thống xác nhận quá trình đảo IP thất bại (Rotation Failed). Proxy này sẽ bị tạm khóa không cho phép tham gia vào các tiến trình tiếp theo nhằm tránh làm hỏng các tác vụ cào dữ liệu.
Ngày cập nhật 2026-03-30 10:56:29
Trước
Exception & Recovery
Tiếp theo
Tổng quan Search API
Built with