声明： 仅供自动化流程研究、自有环境联调与个人学习。请遵守 xAI / 邮箱 / 代理服务商条款与当地法律，勿用于未授权批量滥用。

控制台集中展示任务参数、批次进度、时段成功率、账号补录和黑名单状态；图片会跟随 GitHub 的深浅主题自动切换。

┌─────────────────┐     HTTP proxy      ┌──────────────────┐
│  Camoufox 注册机 │ ──────────────────► │ 本地代理 mixed 口 │
│  (多 worker)     │   127.0.0.1:79xx    │ (可选链式 dialer) │
└────────┬────────┘                     └────────┬─────────┘
         │                                        │
         │ SSO / Device Flow                      ▼
         ▼                                 住宅出口 / 其它出口
   cpa_auth/ · grok2api_auth/
         │
         ▼
┌─────────────────┐
│ webui/monitor   │  读 log/register_results.jsonl · CPA 目录
│ :8787 Live 面板 │  启停 run_until_100 / run_batch_headless
│ + Bearer token  │  浏览器填「访问令牌」→ localStorage
└─────────────────┘

说明：注册机本身只配置一层 HTTP 代理 URL。若需要「先节点再家宽」等链式出口，在代理客户端（如 mihomo dialer-proxy）配置，对注册机透明。

• Python 3.10+
• Linux 无头建议带 Xvfb；macOS 可本机 GUI/有头
• 能访问注册页、临时邮箱 API、auth.x.ai 的网络

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
python -m camoufox fetch           # 必须：下载浏览器引擎（约数百 MB）

cp config.example.json config.json
# 编辑 config.json：邮箱、proxy、cpa_auth_dir 等

pip install 只装 Python 依赖；不执行 camoufox fetch 无法启动浏览器。

生成 token 示例：

# Linux / macOS
python3 -c "import secrets; print(secrets.token_urlsafe(24))"

A. Web 面板（推荐）

export MONITOR_TOKEN='你的长随机串'   # 必设，否则点启动会 401
export MONITOR_HOST=127.0.0.1         # 仅本机；局域网请改成具体网卡 IP
export MONITOR_PORT=8787
export CPA_AUTH_DIR=./cpa_auth
# 可选：需要页面里看原始日志尾时
# export PANEL_INCLUDE_TAIL=1

python webui/monitor.py
# 浏览器打开 http://127.0.0.1:8787/

1. 页面顶部 控制 区找到 面板 Token 输入框
2. 填入与 MONITOR_TOKEN 相同的字符串（自动写入 localStorage）
3. 设模式 / workers / batch 数量 / 再跑 N / 风控满 N → 启动
4. 需要多出口时打开顶部 代理池，导入代理并等待检测完成
5. 打开顶部 邮箱服务，选择 provider、填写对应参数，保存后执行一次连接测试
6. 需要多个自有收信域名轮换时，再展开 域名轮换 · 高级设置 导入域名并保存规则

也可在控制台手动写入：

localStorage.setItem('MONITOR_TOKEN', '你的长随机串')
location.reload()

若未填 token 点启动，会看到：

unauthorized: set MONITOR_TOKEN and pass Authorization: Bearer <token>

这是预期行为，不是注册链路崩溃。

B. 命令行单批（无头 Linux）

xvfb-run -a python -u run_batch_headless.py 20 3
#                        数量↑        并发↑

单批由独立监督进程运行。Playwright/Camoufox 驱动崩溃，或连续超过 GROK_BATCH_IDLE_TIMEOUT 没有输出时，监督进程会结束故障子进程并按原子进度文件 继续剩余数量；已经写入的账号、SSO 和 CPA 文件不会回滚。

C. 编排器

# 由面板写入 log/monitor_control.json（workers / add_count / risk_pause …）
python -u run_until_100.py

D. GUI

python grok_register_ttk.py

前端 api() 会从 Token 输入框 / localStorage.MONITOR_TOKEN / window.MONITOR_TOKEN 自动带头。

• 支持单条或批量粘贴 http://user:pass@host:port、host:port:user:pass，也兼容 HTTPS / SOCKS URL
• 导入时规范化并去重，随后后台并发探活；GET 接口轮询检测进度
• API 和 UI 只返回脱敏端点及 has_auth，不会返回代理账号或密码
• worker 只选择“健康 + 启用”的条目，并在每个新账号创建浏览器前热加载一次
• 一个账号从注册、SSO 到 OAuth 始终固定同一代理，不会中途更换出口
• 网络异常进入短冷却，注册风控进入长冷却；邮箱域名、验证码或邮箱 API 错误不处罚代理
• 面板池已有条目但没有健康代理时任务会明确停止，不会绕过状态回退到旧文件
• proxies.txt 可从界面导入；只有面板池完全未配置时，worker 才直接兼容旧文件 / config.proxy

代理池不抓取、不分发公共代理，只管理操作者自己提供的外部代理。

• 顶部“邮箱服务”统一配置 cloudflare、duckmail、yyds、mailnest、cloudmail、moemail
• 切换服务商时只显示该服务实际支持的字段；保存后新的注册任务读取 config.json
• 已保存的 API Key、JWT 和密码不会通过接口或页面回显；密钥输入留空会保留原值，必须点“清除”并保存才会删除
• “测试当前提供商”使用表单中的未保存内容做非破坏性连通性检查，不会改写 config.json
• config.json 以原子方式更新并保持 0600，现有无关配置项不会被覆盖

域名轮换位于邮箱服务页的高级设置中：

• 支持导入根域名或已有子域名，并绑定 cloudflare、cloudmail、moemail、yyds provider
• 每个 provider 可设置最大活跃域名数；超出部分待命，活跃域名停用或拉黑后自动补位
• xAI 明确拒绝邮箱域名时累计连续失败，达到阈值后自动拉黑；成功提交邮箱后清零连续失败
• 邮箱 API、验证码超时和普通网络异常不会处罚域名，避免把基础设施故障误判成域名质量问题
• 通过“启用”“重置”“删除”管理条目；对应 provider 的面板池配置后，域名池耗尽不会回退旧配置
• duckmail 与 mailnest 的域名由上游服务分配，不能在面板中伪造自定义域名池

域名池只保存域名和运行统计，不保存邮箱账号密码或 provider 密钥。

基于 log/register_results.jsonl（纯 JSON Lines，无横幅污染）：

成功率 = ok / (ok + fail + risk) × 100%
窗口：近 1 小时 / 3 小时 / 12 小时

• 下号前解析出口 ASN，命中则换 sticky / 代理口
• 编排器在风控累计到阈值后，对「几乎只有失败」的 ASN 扩黑
• 自动扩展写入 log/blacklist_state.json，不会改写或执行 Python 源码
• 面板可 刷新列表；重置 为写操作，同样需要 Token

• 补录待处理：读取 accounts/sso_pending.txt，跳过 CPA 已存在邮箱，成功一条立即原子出队
• 扫描全部账号：扫描 accounts/*.txt 并对缺失 CPA 的记录执行转换，不删除原账号文件
• 补录运行在独立子进程，面板可查看数量、上次结果和停止任务
• 命令行等价入口：

python sso_to_auth_json.py \
  --sso accounts/sso_pending.txt \
  --from-config config.json \
  --consume-success \
  --report-json log/recovery_report.json

以下为社区常见踩坑方向，环境差异大，仅供参考：

1. 邮箱：二级域名临时邮往往比批发一级域 / 大盘 Outlook·Google 更省事
2. 出口：质量与冷却窗口影响大；同一出口短时间打太满容易抬失败率
3. 风控字段：服务端 deny 后宜尽早结束 OAuth 路径
4. 并发建议从 2～3 起跳，过高易空页、Turnstile 卡住、代理打满
5. 「资料填写失败」有时是资料页人机未过，不一定是姓名密码写不进
6. 链式代理在客户端配，不在注册机 Python 里写死

.
├── grok_register_ttk.py       # GUI + CLI 主程序
├── register_flow.py           # 注册页流程 / Turnstile
├── browser_session.py         # 会话、出口探测、ASN 黑名单
├── sso_to_auth_json.py        # SSO → OAuth / 写 CPA（auth 文件 0600）
├── camoufox_adapter.py
├── connectivity.py
├── run_batch_headless.py      # 无头批量（包根 Path 后 chdir）
├── run_until_100.py           # 编排器
├── webui/
│   ├── monitor.py             # Live 面板 HTTP 服务
│   ├── security_utils.py      # redact / token 校验
│   ├── blacklist_store.py     # 锁保护的 JSON 黑名单状态
│   ├── proxy_store.py         # 外部代理池、探活、冷却与脱敏视图
│   ├── email_domain_store.py  # 邮箱域名池、拒绝阈值与轮换状态
│   ├── process_utils.py       # 当前项目实例的进程发现 / 停止
│   ├── recovery_ops.py        # SSO / accounts 异步补录
│   └── blacklist_ops.py       # 面板黑名单接口
├── email_providers/
├── tests/                     # 结构 / 脱敏 / chdir 冒烟
├── scripts/                   # xvfb 辅助脚本
├── config.example.json
├── proxies.example.txt
├── requirements.txt
├── DEPLOYMENT.md
├── LICENSE · NOTICE
└── README.md

# 无需 pytest；运行全部发布检查
PYTHON_BIN=.venv/bin/python scripts/run_tests.sh

部署前还应执行：

.venv/bin/python -m pip check
.venv/bin/python scripts/harden_runtime_permissions.py .

Q: 点启动报 unauthorized: set MONITOR_TOKEN...？
A: 服务端已启用写接口鉴权。启动 monitor 时 export MONITOR_TOKEN=...，浏览器 面板 Token 填同一串（或 localStorage.setItem）。硬刷新后再点启动。

Q: 日志尾部显示 raw log tail disabled？
A: 默认关闭防泄密。需要时 export PANEL_INCLUDE_TAIL=1 后重启 monitor.py。

Q: 点启动立刻结束？
A: CPA 已达旧目标。面板填大 再跑 N 个 再启动；编排器用 add_count 抬目标。

Q: 全是「无法解析出口 IP」？
A: 打开顶部“代理池”查看异常和冷却原因，重新检测后只启用健康条目。旧版单代理仍可用 curl -x http://127.0.0.1:端口 https://httpbin.org/ip 单独探活。

Q: 提示“面板代理池没有健康且启用的代理”？ A: 导入项尚未检测、已停用、检测失败或仍在冷却。先在代理池页面执行“检测全部”；面板池已配置时不会回退复用旧文件中的坏代理。

Q: 邮箱域名被自动拉黑，或域名池没有可用项？ A: 只有 xAI 明确拒绝邮箱域名才会累计。打开“邮箱服务”并展开“域名轮换 · 高级设置”查看连续拒绝次数，确认 provider 与域名绑定正确；可手动重置或启用其它待命域名。邮箱 API、验证码超时不会触发域名拉黑。

Q: 邮箱 API 401？
A: 打开“邮箱服务”检查对应 provider 的 Key / JWT / auth_mode，保存后点“测试当前提供商”。页面不会回显已保存密钥，输入框留空表示保留原值。

Q: Address already in use / 面板打不开？
A: 8787 被其它进程占用（例如同机其它服务）。换 MONITOR_PORT，或先释放端口。绑定失败不会自动改绑 0.0.0.0。

Q: Windows？
A: 主要在 macOS 与无界面 Linux 验证；Windows 需自备显示/依赖，欢迎 PR。

Q: 面板和真实进程不一致？
A: 看 log/orch100-stdout.log 与最新 log/batch-*.log；欢迎提 issue / PR。

Q: accounts 文本或待处理 SSO 怎么补录 CPA？ A: 在控制台使用“账号补录”。待处理模式成功后自动出队；扫描全部账号模式会保留原始文本，并跳过本地 CPA 已存在邮箱。

• 必须设置 MONITOR_TOKEN；不要把 token 提交进仓库或贴进公开 issue
• 不要提交 config.json、accounts/、cpa_auth/、proxies.txt、log/proxy_pool.json、log/email_domain_pool.json、真实 stickies、log/monitor.token
• .gitignore 已忽略上述路径
• 运行数据、日志、PID、代理和账号文件使用 0600，父目录使用 0700
• API 响应带 CSP、禁止 iframe、安全类型与 Referrer Policy；请求体上限 64 KiB
• 停止任务只匹配当前项目根目录，不按全系统模糊命令行误杀
• 开源前自查：grep -R api_key --include='*.json' .（勿提交真实配置）
• 面板默认不回传原始日志尾；生产环境固定 PANEL_INCLUDE_TAIL=0

图表根据 GitHub Stargazer 时间戳生成，由 GitHub Actions 每日更新，不依赖第三方绘图接口。

• LINUX DO — 新的理想型社区

MIT — 见 NOTICE 对 AaronL725/grok-register 的归属说明。面板内嵌 Geist 字体使用 SIL OFL 1.1。

• Camoufox
• CLIProxyAPI 等下游生态
• 上游 AaronL725/grok-register
• 社区里分享风控字段与工程经验的各位

Star 鼓励一下 → https://github.com/lij768423-svg/grok-register-panel