nguynbon03/account-pool-manager

Account Pool Manager — Xoay tài khoản thông minh

Quản lý hàng chục/trăm tài khoản web, tự xoay vòng, tự chuyển khi hết credits.

Ý tưởng cốt lõi

Nạp danh sách account (id:pass:proxy)
  → Mỗi account = 1 browser profile riêng
  → Request đến → chọn account còn credits (round-robin)
  → Hết credits → tự chuyển account khác
  → Account bị lỗi → cooldown → thử account khác

Kiến trúc (lấy cảm hứng từ CLIProxyAPIPlus)

AccountPoolManager
  ├── AccountStore          → Lưu trữ danh sách account + trạng thái
  │     ├── account_id      → ID duy nhất
  │     ├── username        → Tên đăng nhập
  │     ├── password        → Mật khẩu
  │     ├── proxy           → Proxy riêng (http://user:pass@host:port)
  │     ├── credits         → Số credits còn lại
  │     ├── status          → active / cooldown / exhausted / banned
  │     ├── session_path    → Đường dẫn file session browser
  │     └── last_used       → Thời điểm dùng gần nhất
  │
  ├── Router                → Chọn account cho request
  │     ├── round-robin     → Xoay vòng đều
  │     └── fill-first      → Dùng hết 1 account rồi mới chuyển
  │
  ├── HealthChecker         → Kiểm tra sức khỏe account định kỳ
  │     ├── Kiểm tra credits
  │     ├── Kiểm tra session còn sống
  │     └── Đánh dấu account chết
  │
  └── ManagementAPI         → API quản lý pool
        ├── POST /pool/import     → Nạp danh sách account
        ├── GET  /pool/status     → Xem trạng thái toàn bộ pool
        ├── POST /pool/add        → Thêm 1 account
        ├── DELETE /pool/remove   → Xóa 1 account
        └── POST /pool/refresh    → Làm mới session 1 account

Định dạng nạp Account

# Dạng cơ bản: username:password:proxy
[email protected]:MyPass123:http://proxy1:8080
[email protected]:MyPass456:socks5://user:pass@proxy2:1080
[email protected]:MyPass789:direct

# Hoặc file CSV:
username,password,proxy
[email protected],MyPass123,http://proxy1:8080

Quy trình xoay Account

1. Request đến
2. Router chọn account (round-robin hoặc fill-first)
3. Kiểm tra account status == active?
   ├── Có → Dùng account này
   └── Không → Chọn account tiếp theo
4. Thực hiện thao tác (tạo video, upload...)
5. Kiểm tra kết quả:
   ├── Thành công → Cập nhật credits, trả kết quả
   ├── Hết credits → Đánh dấu exhausted, chuyển account khác
   ├── Bị ban → Đánh dấu banned, chuyển account khác
   └── Lỗi khác → Retry (tối đa 3 lần), rồi chuyển account
6. Nếu đã thử max_retry_credentials account → trả lỗi

Các mẫu triển khai

Code mẫu:

• references/account-store.py — Lưu trữ và quản lý danh sách account
• references/router.py — Chiến lược chọn account (round-robin, fill-first)
• references/health-checker.py — Kiểm tra sức khỏe account định kỳ
• references/import-accounts.py — Nạp account từ text/CSV, phân tách id:pass:proxy

Quy tắc

• Mỗi account PHẢI có browser profile riêng (không dùng chung)
• Mỗi account PHẢI có proxy riêng (hoặc "direct" nếu không cần)
• KHÔNG BAO GIỜ lưu password dạng plaintext trong log
• Session file lưu trong data/profiles/{account_id}.json
• Cooldown tối thiểu 30s trước khi thử lại account bị lỗi
• Ghi log mọi lần chuyển account: thời gian, lý do, account cũ → mới
• Retry tối đa 3 lần cho 1 request trước khi chuyển account
• Thử tối đa N account cho 1 request (mặc định N=5)

Xem thêm: references/config-example.yaml