本地 Web 控制台：邮箱别名 / 临时邮箱批量注册 Grok，采集 SSO；可选交付到 grok2api（Web 导入 + Build 转换，失败自动补传）和/或 CPA（CLIProxyAPI 热载，chat 探测后入库）。

• 邮箱：Microsoft Outlook/Hotmail 别名，以及 DuckMail / YYDS / Cloudflare Temp Email / Cloud Mail 等临时邮箱
• 注册路径：HTTP 协议注册（推荐，无业务 Chrome）或 浏览器自动化（调试可选）
• 人机：本地 Camoufox Turnstile Solver，或 YesCaptcha
• 交付：SSO 本地落库；可选 grok2api Web→Build（失败 durable 补传）；可选 CPA mint + chat probe 热载
• 状态：协议长跑已在自用环境验证可稳定使用（含 chat 可用号池）

仅供个人学习与自用测试。 请遵守 xAI、邮箱服务商条款与当地法律。

当前推荐路径：协议注册 + 本地 Turnstile Solver；结果页提供 KPI、SSO 折叠与 chat 探测统计。
点击顶栏版本号可打开「关于」。

• 完整开源：本仓库全部源码公开，MIT License
• 仓库地址：https://github.com/HSJ-BanFan/grok-register-web
• 版本更新日志：CHANGELOG.md
• 链接认可社区：LINUX DO
• 协议注册思路：LINUX DO · 协议注册讨论
• 上游参考：AaronL725/grok-register
• 说明：在社区讨论与既有开源方案启发下完成的二次开发 / Web 化改造，不是从零另起炉灶

• 多邮箱服务 — Microsoft Graph / Outlook REST / IMAP XOAUTH2、DuckMail、YYDS、Cloudflare Temp Email、Cloud Mail API
• 协议注册（推荐） — HTTP 发码 / 验码 / 提交 / SSO；浏览器路径保留为调试可选
• 注册 / 上传 / chat 解耦 — Round SUCCESS 表示出号成功；即时上传失败不推翻注册结果
• grok2api 交付（可选） — Web 导入 → Build 转换；瞬时失败重试 + durable 补传
• CPA 热载（可选） — mint → chat probe → xai-*.json；不可用进 dead 目录
• 本地 Turnstile Solver — Camoufox HTTP API，协议路径推荐
• 结果管理 — SSO / 账号导出、KPI、chat 探测统计
• 旧账号批量补激活 — 历史 SSO 补 TOS / 生日 / CF 出口上下文

完整说明见 docs/USAGE.md。

Windows 本地运行是当前正式推荐方式。macOS / Linux 可运行，但真实注册验证强度低于 Windows。

可选：本地 HTTP 或 SOCKS 代理。容器内不要用容器自己的 127.0.0.1 指宿主机代理。

pip install -r requirements.txt

# 协议路径强烈建议
pip install -r requirements-solver.txt
python -m camoufox fetch

python app.py

默认打开 http://localhost:5000。

python app.py --port 8080
python app.py --host 0.0.0.0 --port 5000 --allow-remote   # 仅限可信网络

Windows 若遇 WinError 216，可指定 Chrome：

$env:GROK_REGISTER_BROWSER_PATH = "$env:ProgramFiles\Google\Chrome\Application\chrome.exe"
python app.py

Linux 无桌面跑浏览器路径时用 Xvfb（不要硬开无头）：

bash scripts/run_with_xvfb.sh --host 0.0.0.0 --port 5000 --allow-remote

1. 邮箱页导入 Microsoft 账号，或设置临时邮箱
2. 设置页：
   • 注册传输后端 = 协议
   • Cloudflare 人机验证 = 仅外置 + 本地求解器（http://127.0.0.1:5072）
   • 并发注册数 = 1
   • 关闭「注册后打开 grok.com 做 Web 激活」
   • 可选：grok2api 自动上传 / 对话可用性探测 / CPA
3. 注册页启动 1 轮验证
4. 日志出现 Round SUCCESS（及可选 delivery 完成）

更细的操作步骤：docs/USAGE.md
设置项与环境变量：docs/CONFIGURATION.md

SSO cookie found (152 chars)
grok2api auto pipeline completed: web_created=1 build_created=1 ...
Round N SUCCESS! Duration: 28.0s transport=http turnstile=local_solver

更多组合见 docs/CONFIGURATION.md。

注册成功 ≠ 即时上传成功 ≠ chat 可用。
交付失败时不要重注册；完整故障表见 docs/TROUBLESHOOTING.md。

grok-register/
├── app.py
├── config.py
├── requirements.txt
├── requirements-solver.txt
├── core/                 # 注册、激活、邮箱、浏览器、交付
├── services/             # 本地 Turnstile Solver 托管
├── api/                  # REST + WebSocket
├── static/               # 前端 SPA
├── templates/
├── docs/
│   ├── USAGE.md
│   ├── CONFIGURATION.md
│   ├── TROUBLESHOOTING.md
│   └── screenshots/
├── scripts/
├── tests/
└── data/                 # 运行时生成（勿提交）

Flask · Flask-SocketIO · DrissionPage · curl_cffi · SQLite · 原生 ES Module 前端

python -m unittest discover -s tests -v

• 默认绑定本机；绑定非本机地址必须显式 --allow-remote
• 账号、Token、密码仅存本地 data/，请勿提交公开仓库
• 资料/环境异常时会在 data/diagnostics/ 写诊断文件
• CPA / grok2api 交付默认关闭；开启后注意凭证目录权限
• 提交 Issue 前请脱敏，清单见 docs/TROUBLESHOOTING.md

• 本项目在社区讨论与既有开源方案启发下完成二次开发 / Web 化改造
• 感谢 LINUX DO 社区
• 协议注册思路参考：LINUX DO · 协议注册讨论
• 上游参考：AaronL725/grok-register

MIT