这是一个用于批量注册 Grok/xAI 账号的 Python 自动化项目，基于 Camoufox 反检测浏览器实现注册链路，并提供 Web Live 监控面板。它覆盖邮箱 OTP、资料填写、Turnstile、SSO、Device/OAuth、CPA/Grok2API auth 写入等流程，同时支持代理池、ASN 黑名单、成功率统计、失败补录、任务启停和并发控制。项目更偏向自动化注册流程研究、账号生产管线测试和私有环境联调，不适合用于违反服务条款的大规模滥用。
适用领域
浏览器自动化 / 账号注册自动化 / 反检测浏览器 / 代理池管理 / Web 运维面板 / 临时邮箱集成 / OAuth/SSO 流程自动化 / 风控监控与失败恢复
配置难度
较高。该项目不是简单脚本，需要理解 Python 虚拟环境、Camoufox/Playwright 类浏览器自动化、临时邮箱 API、HTTP/SOCKS 代理、Linux 无头环境、Token 鉴权、日志排错和目标站点风控机制。对普通初学者不友好，更适合有自动化和运维经验的开发者。
商业价值
商业价值取决于合规使用场景。在合法授权的内部测试、自动化流程研究、SSO/OAuth 联调、代理质量评估和 Web 运维面板开发学习中，它有较高工程参考价值。若用于批量生产第三方平台账号，则存在明显法律、服务条款和账号封禁风险，不建议作为正式商业化服务使用。
01
技术亮点
- 功能链路完整：覆盖邮箱 OTP、资料页、Turnstile、SSO、Device/OAuth、CPA/Grok2API 写入。
- 带 Live Web 面板：可以启停任务、调整 workers、设置 batch 数量、查看 1h/3h/12h 成功率和黑名单状态。
- 代理池能力较强：支持批量导入、去重、探活、启停、删除、脱敏展示、冷却和健康选择。
- 风控处理细致：启动前解析出口 IP/ASN，支持 ASN 黑名单和风控阈值暂停。
- 安全意识较好：MONITOR_TOKEN 鉴权、日志尾部默认关闭、代理凭据脱敏、运行文件 owner-only 权限、CSP 和请求体限制。
- 失败恢复机制实用：支持 SSO pending 和 accounts 文本补录，成功后原子出队，跳过已存在账号。
- 对部署踩坑有说明：包括 Camoufox fetch、Xvfb、Token、端口占用、代理池健康、邮箱 API 401 等常见问题。
- MIT 许可证，且声明了上游 AaronL725/grok-register 的归属。
02
目标用户
- 研究 Web 自动化、浏览器指纹和注册流程的开发者
- 需要在自有环境中联调 Grok/xAI 登录、SSO、OAuth 或 CPA auth 文件的技术人员
- 熟悉 Python、Playwright/Camoufox、代理和临时邮箱 API 的高级用户
- 需要批量测试注册链路稳定性的运维或自动化工程师
- 想学习 Web 面板如何管理长任务、代理池、日志和状态文件的开发者
03
配置要求
- Python 3.10+。
- Linux 无头环境建议安装并使用 Xvfb；macOS 可使用 GUI/有头模式。
- 必须执行 python -m camoufox fetch 下载 Camoufox 浏览器引擎。
- 需要可访问 Grok 注册页、临时邮箱 API、auth.x.ai 的网络环境。
- 需要配置 config.json，包括 email_provider、defaultDomains、对应邮箱服务 API 参数、proxy、register_workers、register_count、cpa_auth_dir 等。
- 如使用 Cloudflare Worker 邮、DuckMail、YYDS、MailNest、CloudMail、MoeMail 等，需要准备对应 API 地址、密钥或域名。
- Web 面板写接口必须设置 MONITOR_TOKEN，并在前端使用相同 Token。
- 如启用代理池，需要导入自有外部代理，并等待健康检测完成。
- CPA_AUTH_DIR、BATCH_LOG、BLACKLIST_STATE_FILE、PROXY_POOL_STATE_FILE 等环境变量可按部署环境调整。
- 运行数据目录如 accounts、cpa_auth、log、proxies.txt 应避免提交到 Git，并建议保持 0600/0700 权限。
04
适用场景
- 在受控环境中研究 Grok 注册全链路自动化，包括 OTP、Turnstile、SSO 和 OAuth
- 搭建本地 Web 面板，监控批量注册任务的运行状态、并发、成功率和失败原因
- 管理外部代理池，检测代理健康状态、记录出口 IP/ASN，并根据风控情况自动冷却或拉黑
- 将已有 SSO 或 accounts 文本补录转换为 CPA/Grok2API auth 文件
- 评估不同邮箱提供商、代理出口、并发数对注册成功率的影响
- 学习如何设计带 Token 鉴权、脱敏、权限加固和日志控制的轻量级运维控制台
05
部署与配置
- 安装 Python 3.10 或更高版本。
- 克隆仓库：git clone https://github.com/lij768423-svg/grok-register-panel.git
- 进入目录：cd grok-register-panel
- 创建虚拟环境：python3 -m venv .venv
- 激活虚拟环境：source .venv/bin/activate；Windows 使用 .venv\Scripts\activate。
- 安装依赖：pip install -r requirements.txt
- 下载 Camoufox 浏览器引擎：python -m camoufox fetch。该步骤必须执行，否则浏览器无法启动。
- 复制配置文件：cp config.example.json config.json
- 编辑 config.json，配置邮箱提供商、临时邮箱 API、代理、并发数、CPA auth 目录等。
- 设置面板 Token：export MONITOR_TOKEN='你的长随机字符串'
- 可选设置面板地址和端口：export MONITOR_HOST=127.0.0.1；export MONITOR_PORT=8787
- 启动 Web 面板：python webui/monitor.py
- 浏览器打开 http://127.0.0.1:8787/，在页面中填入与 MONITOR_TOKEN 相同的访问令牌。
- 如在无头 Linux 命令行单批运行，可使用：xvfb-run -a python -u run_batch_headless.py 20 3
06
风险与注意事项
- 合规风险高：项目用于批量注册 Grok 账号，容易违反 xAI、邮箱服务商、代理服务商条款，也可能触及当地法律或平台反滥用规则。
- 账号与代理资产风险：config.json、accounts、cpa_auth、proxies.txt、proxy_pool.json 等文件包含敏感信息，泄露后可能导致账号、代理或 API Key 被盗用。
- 服务稳定性风险：目标站点注册流程、Turnstile、风控字段、OAuth 流程变化后，自动化脚本可能快速失效。
- 代理质量依赖强：出口 IP、ASN、冷却窗口和代理健康直接影响成功率，低质量代理可能导致大量失败或封禁。
- 运行资源消耗较高：Camoufox 多 worker 会占用较多 CPU、内存和网络资源，浏览器引擎下载体积也较大。
- 面板暴露风险：如果 MONITOR_HOST 绑定到公网或局域网地址且 Token 设置不当，可能被他人控制任务、读取状态或操作代理池。
- 平台反自动化对抗风险：使用反检测浏览器和批量注册可能被平台识别并限制，长期可维护性不确定。
- Windows 支持不充分：README 明确主要验证环境是 macOS 和无界面 Linux，Windows 用户可能需要自行处理依赖和显示环境。
2026-08-05
第20名
新收录 · github_search
2026-08-04
第24名
新收录 · github_search
2026-08-03
第20名
新收录 · github_search
2026-08-02
第21名
新收录 · github_search
2026-08-01
第20名
新收录 · github_search
2026-07-31
第27名
新收录 · github_search
