Any Auto Register

Tự động hóa tài khoản cho 11+ nền tảng AI · Chế độ giao thức / trình duyệt · Khởi động một chạm trên Mac / Windows

Tải bản desktop · Vấn đề được giải quyết · Ảnh chụp · Cộng đồng · 中文 · English

Đây là kho chính thức của lxf746/any-auto-register — kho gốc của tác giả với các cập nhật mới nhất. Các kho cùng tên khác đều là fork.

Dự án chỉ dành cho học tập và nghiên cứu, không được sử dụng cho mục đích thương mại trái phép. Người dùng có trách nhiệm tự đánh giá và tuân thủ điều khoản dịch vụ của các nền tảng đích, đồng thời tự chịu trách nhiệm về mọi hậu quả phát sinh khi sử dụng.

Vấn đề được giải quyết

Đa số dự án cùng loại chỉ trả lời "đăng ký một nền tảng như thế nào" và bỏ ngỏ phần kỹ thuật còn lại: quản lý email, vượt captcha, xoay proxy, duy trì tài khoản sau đăng ký, refresh token hết hạn, định vị lỗi. Any Auto Register xử lý tất cả.

	Công cụ khác	Any Auto Register
Triển khai	CLI / Docker / script `.py`	Desktop client (Mac / Win), nhấp đôi là chạy, UI React tích hợp
Độ phủ nền tảng	1-3	11+ nền tảng + Anything adapter tổng quát, mở rộng kiểu plugin
Giải pháp email	Chủ yếu IMAP	9 kênh: MoeMail / Cloudflare tự host / TempMail / DDG Email, v.v.
Chế độ thực thi	Chỉ trình duyệt	Pure protocol (nhanh nhất) / Headless / Headed
Vòng đời đầy đủ	Đăng ký xong là bỏ	Kiểm tra định kỳ + refresh token + cảnh báo trial + cảnh báo rủi ro
Phân tích dữ liệu	Không	Dashboard tỷ lệ thành công, quy lỗi (proxy bị chặn / email lỗi / xác minh phụ)
Đồng bộ API gateway	Không	Tự đẩy lên Any2API, tầng giao thức tương thích OpenAI thống nhất
Kiến trúc	Thường hardcode	Pluggable hoàn toàn: platform / mailbox / captcha / SMS / proxy đều cắm rời

Kết hợp với gateway Any2API cho pipeline đầy đủ: đăng ký hàng loạt → tự đẩy → dùng ngay như API tương thích OpenAI / Claude.

Xem nhanh

Ảnh chụp từ bản desktop mới nhất (v1.0.29), cập nhật theo từng phiên bản. Ảnh Hero phía trên là dashboard Tổng quan — sáu chỉ số thời gian thực (tổng tài khoản / còn sống / lỗi / đăng ký hôm nay / hàng đợi / số lần thử lại), kèm view kép tỷ lệ thành công + giám sát vòng đời và panel tóm tắt môi trường máy. Dưới đây là các workspace còn lại:

Account pool — quản lý tài khoản đa nền tảng

Tab theo từng nền tảng, hiển thị mật khẩu / người quản lý / trạng thái / hạn mức / link thanh toán / lần truy vấn gần nhất. Hỗ trợ tìm kiếm, import / export hàng loạt, copy từng dòng, mở link thanh toán.

Task queue — đăng ký hàng loạt và lịch sử

Toàn bộ tác vụ và tác vụ đang chạy trong một chỗ. Mỗi thẻ hiển thị nền tảng, số thành công / tổng, timestamp, trạng thái. Tạm dừng toàn bộ, dọn hàng đợi, hoặc mở log trực tiếp của từng tác vụ.

Log đăng ký — truy vết từng bước

Mọi bước trong luồng đăng ký được stream về frontend qua SSE — đổi OAuth code, lấy token, truy vấn hạn mức — tất cả đều nhìn thấy. Khi lỗi xảy ra, bạn biết chính xác ở bước nào.

Cài đặt — tùy chọn cho desktop

Theme / ngôn ngữ / proxy mặc định toàn cục, kèm các tùy chọn chỉ có ở desktop: khởi động cùng máy, minimize xuống tray, đóng-xuống-tray, kiểm tra cập nhật khi khởi động, thư mục auto-backup.

Năng lực cốt lõi

Phân nhóm theo trách nhiệm:

Luồng đăng ký

Nền tảng: ChatGPT / Cursor / Kiro / Trae.ai / Tavily / Grok / Blink / Cerebras / OpenBlockLabs / Windsurf, kèm Anything adapter tổng quát
Email: MoeMail tự host / Cloudflare Worker tự host / Laoudo / DuckMail / Testmail / Freemail / TempMail.lol / Temp-Mail Web / DuckDuckGo Email
Captcha: YesCaptcha / 2Captcha / Solver cục bộ (Camoufox)
SMS: SMS-Activate / HeroSMS
Chế độ thực thi: protocol (không browser, nhanh nhất) / Headless / Headed, chuyển đổi theo nền tảng
2FA cục bộ: TOTP tích hợp sẵn, không cần app bên thứ ba

Vận hành

Vòng đời: kiểm tra hợp lệ định kỳ + tự refresh token + cảnh báo trial, refresh một chạm từ dashboard
Trung tâm rủi ro: cảnh báo tập trung Token hết hạn / Trial sắp cạn / Proxy không kết nối được
Thống kê tỷ lệ thành công: tỷ lệ toàn cục + quy lỗi (thành công ngay / xác minh phụ / proxy bị chặn / email lỗi), tách theo nền tảng / ngày / proxy
Hàng đợi tác vụ: lịch sử đăng ký hàng loạt + tiến độ thời gian thực + log từng tác vụ

Hệ thống

Proxy pool: static (weight theo tỷ lệ thành công) + API extraction động + rotating gateway, tự vô hiệu hóa khi lỗi
Đồng bộ Any2API: tự đẩy tài khoản đăng ký lên gateway — dùng được ngay
Định dạng export: JSON / CSV / CPA / Sub2API / Kiro-Go / Any2API admin.json
Concurrency & log: concurrency cấu hình được, SSE log trực tiếp, task runner bền vững
Kiến trúc plugin: platform / mailbox / captcha / SMS / proxy driver — đều cắm rời

Bắt đầu nhanh

Desktop (khuyến nghị)

🚀 Zero config. Electron đóng gói sẵn cả backend + frontend, nhấp đôi là chạy.

Nền tảng	Tải xuống
🍎 macOS (Intel / Apple Silicon)	Tải `.dmg` từ Releases
🪟 Windows	Tải `.exe` từ Releases

Cài → khởi động → nhập activation code (nhận từ nhóm) → chọn nền tảng → cấu hình email → bắt đầu đăng ký.

Docker

mkdir -p any-auto-register && cd any-auto-register

cat > docker-compose.yml <<'EOF'
services:
  app:
    image: ghcr.io/lxf746/any-auto-register:latest
    ports:
      - "8000:8000"   # Web UI
      - "6080:6080"   # noVNC (xem browser)
      - "8889:8889"   # Turnstile Solver
    environment:
      - DISPLAY=:99
      # - APP_PASSWORD=changeme
    volumes:
      - ./data:/app/data
    restart: unless-stopped
EOF

docker compose up -d

Dịch vụ	URL	Ghi chú
Web UI	`http://localhost:8000`	Giao diện chính
noVNC	`http://localhost:6080/vnc.html`	Xem browser (chế độ headed)
Solver	`http://localhost:8889`	Bộ giải Turnstile captcha

Khi triển khai cloud, mở port 8000 / 6080 / 8889.

Từ mã nguồn

Mã nguồn bao gồm luồng đăng ký cốt lõi và toàn bộ hệ provider — phù hợp để tự host và mở rộng. Kiểm soát hàng đợi tác vụ nâng cao, quản lý activation code, tăng cường luồng thanh toán, và các bản thích ứng nền tảng mới nhất chỉ đi kèm bản desktop.

Yêu cầu Python 3.11+ / Node.js 18+:

git clone https://github.com/lxf746/any-auto-register.git
cd any-auto-register/account_manager

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

cd frontend && npm install && npm run build && cd ..

# Tùy chọn — cần cho chế độ browser
python3 -m playwright install chromium
python3 -m camoufox fetch

python3 -m uvicorn main:app --port 8000

Mở http://localhost:8000. Frontend hot-reload xem mục Phát triển.

Cấu hình

Provider email

Chọn một dịch vụ email để nhận mã xác minh. Cấu hình email, captcha, SMS đều do provider catalog ở backend điều khiển — trang Settings trong Web UI là CRUD dạng danh sách: cấu hình hiện có ở bên trái, editor thống nhất ở bên phải. Provider mới thêm ở backend sẽ tự xuất hiện sau khi refresh — không cần sửa frontend.

Provider	Ghi chú
MoeMail (khuyến nghị)	Temp mail tự host dựa trên cloudflare_temp_email. Không cần cấu hình — địa chỉ sinh tự động.
Laoudo	Email custom-domain cố định. Ổn định nhất, phù hợp dùng lâu dài.
Cloudflare Worker tự host	Tự deploy dựa trên `cloudflare_temp_email`. Toàn quyền kiểm soát.
Testmail	Chế độ namespace `testmail.app`, phù hợp tác vụ song song (auto tag + lọc theo timestamp).
DuckDuckGo Email	Alias `@duck.com` riêng tư + IMAP forwarding.
Freemail	Cloudflare Worker tự host, hỗ trợ admin token hoặc username / password.
DuckMail	Temp mail công cộng, không cần cấu hình. Một số khu vực cần proxy.
TempMail.lol	Temp mail công cộng, tự sinh địa chỉ ẩn danh.
Temp-Mail Web	Dựa trên `web2.temp-mail.org`.

Định dạng các trường được mô tả trực tiếp trong editor — backend tự render form từ provider catalog tương ứng.

Provider captcha

Dịch vụ	Ghi chú
YesCaptcha	Đăng ký tại yescaptcha.com để lấy Client Key
2Captcha	Đăng ký tại 2captcha.com để lấy API Key
Local Solver	Solver Camoufox cục bộ, chạy `python3 -m camoufox fetch` trước

Proxy pool

Static proxy — thêm thủ công ở trang Proxy, weight theo tỷ lệ thành công, tự vô hiệu hóa sau 5 lần lỗi liên tiếp
API extraction — kéo IP động qua HTTP API
Rotating gateway — entry cố định, IP exit khác nhau ở mỗi request — dùng cho BrightData / Oxylabs / IPRoyal, v.v.

Khi proxy provider được bật trong database, đăng ký sẽ thử dynamic proxy trước và fallback về static pool nếu lỗi.

Provider SMS

Cho các nền tảng yêu cầu xác minh số điện thoại (ví dụ Cursor):

Dịch vụ	Ghi chú
SMS-Activate	API key + quốc gia mặc định
HeroSMS	API key + service code, country ID, giá tối đa, chính sách reuse số

Tham số sms_provider ở cấp tác vụ ưu tiên hơn; nếu không chỉ định, dùng SMS provider mặc định.

Nâng cao

Vòng đời tài khoản

Lifecycle manager nền chạy tự động:

Kiểm tra hợp lệ mỗi 6 giờ — đánh dấu tài khoản không còn hợp lệ
Refresh token mỗi 12 giờ — refresh token sắp hết hạn (hiện hỗ trợ ChatGPT)
Cảnh báo trial — đánh dấu tài khoản sắp hết, cập nhật trạng thái khi đã hết

Trigger thủ công: POST /api/lifecycle/{check|refresh|warn}, GET /api/lifecycle/status để xem trạng thái.

Thống kê tỷ lệ thành công & quy lỗi

GET /api/stats/overview — tổng quan toàn cục
GET /api/stats/by-platform — theo nền tảng
GET /api/stats/by-day?days=30 — xu hướng theo ngày
GET /api/stats/by-proxy — xếp hạng proxy
GET /api/stats/errors?days=7 — quy lỗi tổng hợp

Tích hợp Any2API

Kết hợp với gateway Any2API — tài khoản đăng ký xong được tự đẩy lên và dùng được ngay.

Cấu hình trong Settings:

Trường	Mô tả
`any2api_url`	URL Any2API instance, ví dụ `http://localhost:8099`
`any2api_password`	Mật khẩu admin của Any2API

Đích đẩy theo nền tảng:

Nền tảng	Đích
Kiro	`kiroAccounts` pool
Grok	`grokTokens` pool
Cursor	`cursorConfig` cookie
ChatGPT	`chatgptConfig` token
Blink	`blinkConfig` credentials
Windsurf	`windsurfAccounts` pool

Nếu không đặt any2api_url, tích hợp này sẽ được bỏ qua một cách yên lặng.

Công nghệ

Tầng	Công nghệ
Backend	FastAPI + SQLite (SQLModel)
Frontend	React + TypeScript + Vite + TailwindCSS
HTTP	curl_cffi (giả lập browser fingerprint)
Browser automation	Playwright / Camoufox
Desktop	Electron + đóng gói Nuitka

Phát triển

Cấu trúc dự án

account_manager/
├── main.py                 # FastAPI entry
├── api/                    # HTTP routes
│   ├── accounts.py         # account CRUD + export
│   ├── account_providers.py     # mailbox / captcha / SMS / proxy
│   ├── registration.py          # registration tasks + SSE
│   ├── query.py                 # truy vấn trạng thái tài khoản
│   ├── payment.py               # link thanh toán / hành động
│   ├── transfer.py              # import / export
│   ├── platforms.py             # danh sách nền tảng
│   ├── provider_definitions.py  # định nghĩa provider
│   ├── proxies.py               # quản lý proxy
│   ├── health.py                # health check
│   └── system.py                # cài đặt hệ thống / Solver
├── application/            # application services
├── domain/                 # domain models
├── infrastructure/         # repositories + runtime adapters
├── core/                   # base classes (platform / mailbox / captcha / SMS)
├── platforms/              # platform plugins
├── providers/              # provider plugins
├── services/               # dịch vụ nền (Solver / task runner)
├── customer_portal_api/    # API người dùng + admin
├── electron/               # đóng gói Electron desktop
├── tests/                  # tests
└── frontend/               # React frontend

Chế độ phát triển (frontend hot-reload)

cd frontend
npm run dev
# Mở http://localhost:5173 — Vite proxy API về backend

Entry duy nhất là main:app. Tất cả route backend nằm dưới /api/*. Xem docs/frontend-api-contract.md cho API contract.

Thêm platform plugin

Layout plugin:

platforms/myplatform/
├── plugin.py
├── registration/
│   ├── module.py       # entry registration module
│   ├── protocol.py     # protocol core
│   ├── worker.py       # mailbox provider → protocol flow
│   ├── browser.py      # browser registration (tùy chọn)
│   └── oauth.py        # browser OAuth (tùy chọn)
├── query.py            # khả năng query (tùy chọn)
├── payment.py          # khả năng payment (tùy chọn)
└── transfer.py         # khả năng import / export (tùy chọn)

plugin.py tối thiểu:

from core.platform_plugin import ConfiguredPlatformPlugin
from core.plugin_registry import register

@register
class MyPlatformPlugin(ConfiguredPlatformPlugin):
    name = "myplatform"
    display_name = "My Platform"
    version = "2.0.0"
    query_class = "MyPlatformQuery"
    payment_class = "MyPlatformPayment"
    transfer_class = "MyPlatformTransfer"

Hệ thống quét platforms/*/plugin.py khi khởi động và auto-load mọi thứ đăng ký qua @register. Để xem registration/module.py đầy đủ, tham khảo các platform có sẵn (platforms/kiro/, platforms/chatgpt/).

Đóng góp

Fork kho này
Tạo nhánh tính năng: git checkout -b feature/my-feature
Commit: git commit -m 'feat: add my feature' (khuyến nghị Conventional Commits)
Push: git push origin feature/my-feature
Mở Pull Request

Câu hỏi thường gặp

Captcha liên tục thất bại?

Xác nhận provider captcha cấu hình đúng (YesCaptcha Client Key hoặc local Solver)
Trong chế độ protocol, ưu tiên dịch vụ remote (YesCaptcha / 2Captcha)
Trong chế độ browser, Camoufox thử click Turnstile checkbox trước rồi fallback về remote solver
Nếu vẫn lỗi, kiểm tra chất lượng IP proxy — IP rủi ro cao gặp challenge khắt khe hơn

Proxy bị chặn / tỷ lệ thành công thấp?

Kiểm tra thống kê từng proxy ở trang Proxy và vô hiệu hóa các proxy yếu
Dùng residential proxy thay vì IP datacenter
Giảm concurrency để tránh burst từ cùng một IP
Mỗi nền tảng có độ nhạy IP khác nhau — cân nhắc proxy pool riêng cho từng nền tảng

Solver khởi động timeout?

[Solver] startup timeout nghĩa là local Turnstile Solver không pass health-check trong 30s. Main service vẫn khởi động. Nguyên nhân thường gặp: Camoufox tải lần đầu, thiếu browser deps, hoặc port 8889 bị chiếm.

Chạy python3 -m camoufox fetch cục bộ, sau đó click "Restart Solver" trong Settings
Để bỏ qua local Solver, cấu hình YesCaptcha hoặc 2Captcha và chọn remote solver ở task config
Với Docker, ưu tiên image build sẵn; với bare metal, kiểm tra port 8889 và cài Camoufox

Build ARM image lỗi?

Nếu log build hiện src/pages/Accounts.tsx ... TS6133/TS7006, lỗi thật ở build TypeScript của frontend — không phải vấn đề ARM hay apt. Chạy cục bộ trước:

cd frontend && npm run build

Sau đó rebuild:

docker compose build --no-cache && docker compose up -d

Cộng đồng

Tham gia nhóm người dùng để cập nhật mới nhất, activation code, kinh nghiệm cấu hình và mẹo đăng ký:

Nhóm QQ	Mã	Trạng thái
Nhóm 1	`1081650009`	Đã đầy
Nhóm 2	`1097916468`	Đã đầy
Nhóm 3	`100799970`	Đã đầy
Nhóm 4	`469274724`	Đã đầy
Nhóm 5	`906077873`	Còn chỗ

Tìm mã nhóm trong QQ để tham gia. Báo bug và yêu cầu tính năng vui lòng dùng Issues.

Star History

Nếu dự án này giúp bạn tiết kiệm công việc lặp lại, một ⭐ giúp nhiều người khác tìm thấy.

Giấy phép

AGPL-3.0. Học tập và nghiên cứu cá nhân được sử dụng tự do; sử dụng thương mại phải tuân thủ AGPL-3.0 (sản phẩm phái sinh phải open source).

FilesExpand file tree

README_vi.md

Latest commit

History