lij768423-svg/grok-register-panel

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

控制台集中展示任务参数、批次进度、时段成功率、账号补录、BFS 扫描和黑名单状态。

代理池：批量导入、探活、冷却和出口质量

邮箱服务：六种 provider 与高级域名轮换

以上图片使用脱敏示例数据，并会跟随 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+
• 能访问注册页、临时邮箱 API、auth.x.ai 的网络

Linux 容器必须保留 procfs（通常为默认的 /proc 挂载），面板依赖它读取并安全停止 当前项目的任务进程。

git clone https://github.com/lij768423-svg/grok-register-panel.git
cd grok-register-panel

python3 -m venv .venv
source .venv/bin/activate          # Linux / macOS
# Windows PowerShell: .venv\Scripts\Activate.ps1

pip install -r requirements.txt
python -m camoufox fetch           # 必须：下载浏览器引擎（约数百 MB）

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

Windows 也可以一条命令完成安装，然后用本机代理 URL（http / socks5）跑批，不必 SSH 到 Linux：

powershell -ExecutionPolicy Bypass -File scripts\setup_windows.ps1
# 编辑 config.json，或在面板导入代理池
powershell -ExecutionPolicy Bypass -File scripts\run_windows_batch.ps1 -Count 1 -Workers 1
powershell -ExecutionPolicy Bypass -File scripts\run_windows_panel.ps1

Windows 不要把 PLAYWRIGHT_NODEJS_PATH 指到 scripts/playwright-node（那是 bash 包装）。运行时会解析 node.exe 或 Playwright 自带 Node，并用带引号的 NODE_OPTIONS --require 注入 EPIPE 保护。代理请写 Windows 本机可达 的 URL（例如 socks5://user:pass@gate.example:1000），不要沿用 Linux 上的 127.0.0.1:82xx mixed 口。

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/

从面板或编排器启动批处理时会自动选择运行方式：Linux 无 DISPLAY / WAYLAND_DISPLAY 时使用 Xvfb，Linux 有显示以及 macOS/Windows 均直接启动。

1. 页面顶部 控制 区找到 面板 Token 输入框
2. 填入与 MONITOR_TOKEN 相同的字符串（自动写入 localStorage）
3. 设模式 / workers / batch 数量 / 再跑 N / 风控满 N → 启动
4. 需要多出口时打开顶部 代理池，导入代理并等待检测完成
5. 打开顶部 邮箱服务，优先选 Outlook RT，填写库存路径后保存并测试。不要把域名邮箱当主路径
6. 需要入库时短测降智：打开 quality_probe_on_register。存量号用顶部 降智测试 批量复测

从 Live 面板启动的单批和持续编排默认启用静态缓存。直接从命令行启动时，需要在标准命令上增加环境变量：

GROK_STATIC_ASSET_CACHE=1 \
GROK_STATIC_CACHE_DIR="$PWD/log/static-asset-cache" \
  xvfb-run -a python -u run_batch_headless.py 1 1

也可直接使用兼容入口 run_batch_headless_static_cache.py 或 run_until_100_static_cache.py。

缓存只处理 GET 静态资源；文档、XHR/fetch、WebSocket、Turnstile 和账号相关请求始终直连。

每个批次还会自动生成 log/batch_traffic.json。注册浏览器使用 HTTP/HTTPS 代理时，项目会在原代理前启动独立的 127.0.0.1 计量转发器，面板据此展示 真实上行、下行与总字节数。批次结束后还会把聚合结果写入 owner-only 的 log/batch_traffic_history.json（最多 500 批），用于展示每批平均流量和每个成功号 平均流量。成功号均值会包含失败尝试产生的流量，表示实际成功账号成本。计量文件 不保存代理 URL、用户名、密码或请求内容；SOCKS 代理会保持原链路并标记为未计量。

也可在控制台手动写入：

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
#                        数量↑        并发↑

# Linux 有显示 / macOS / Windows
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、outlook_rt、inbucket
• outlook_rt 从本地 jsonl 库存取号（非购买），用 MSA refresh_token 刷 Graph 收 xAI 验证码
• inbucket 使用自建 Inbucket 实例：填实例地址和收信根域名即可，邮箱即建即用，无需注册 API；根域名可配多个轮换，并可按 inbucket_random_levels 叠加随机多级子域（需泛解析收信）
• 切换服务商时只显示该服务实际支持的字段；保存后新的注册任务读取 config.json
• 已保存的 API Key、JWT 和密码不会通过接口或页面回显；密钥输入留空会保留原值，必须点“清除”并保存才会删除
• “测试当前提供商”使用表单中的未保存内容做连通性检查，不会改写 config.json；outlook_rt 刷新成功时会原子保存上游轮换后的 RT，避免库存保留已失效凭据，但不会标记邮箱已用
• 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

SSO 读 grok.com botFlagSource 已经不能判断风控。改用 CPA / Grok2API 的 access_token，经配置的家宽出口发短题流式回复（见到 thinking 即停），只按有没有 thinking 分类。quality_probe_on_register 默认关闭：打开后 SSO→OAuth 写盘才会立刻测。

python scripts/check_quality.py --dir cpa_auth --from-config config.json \
  --workers 3 --export log/quality_degraded.jsonl \
  --risk-export log/quality_risk.jsonl

旧的 grok.com botFlagSource / policy=deny 扫描仍可打开，但不再作为风控门禁，注册也不会再据此跳过 OAuth。请用上面的降智测试。

xAI 部分 access_token 的 payload 会带 bfs 字段（常见值 2）。只要 key 存在即视为标记，与 grok.com 的 botFlagSource / policy=deny 不是同一信号。

config.json 可选：

无法解码的 token 会显示为 unknown，不会伪造为 clean；启用 bfs_skip_cpa 时，面板注册路径的 unknown 账号不会写入 CPA/Grok2API，而是进入待重转队列。CLI 则跳过本次写入并在报告中记为失败。

# 扫描本地 CPA 目录
python scripts/check_bfs.py --dir cpa_auth --export log/bfs_flagged.jsonl

# 单 token 诊断（不回显原文）
python scripts/check_bfs.py --token 'eyJ...'

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

1. 邮箱：优先 Outlook 等真实邮箱；不要用域名邮箱当主路径
2. 出口：优先家宽；质量与冷却窗口影响大，同一出口短时间打太满容易抬失败率和降智
3. 风控 / 降智：不要再用 SSO botFlag；要入库短测就打开 quality_probe_on_register，存量用面板「降智测试」
4. JWT bfs：与页面 botFlag 分开统计；入库前可用面板/CLI 批量扫 CPA
5. 并发建议从 2～3 起跳，过高易空页、Turnstile 卡住、代理打满
6. 「资料填写失败」有时是资料页人机未过，不一定是姓名密码写不进
7. 链式代理在客户端配，不在注册机 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）
├── quality_probe.py           # 短题降智 / 风控探测（开关打开才入库测、面板复测）
├── camoufox_adapter.py
├── connectivity.py
├── batch_supervisor.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_provider_store.py # 邮箱 provider 配置、测试与密钥保护
│   ├── email_domain_store.py  # 邮箱域名池、拒绝阈值与轮换状态
│   ├── process_utils.py       # 当前项目实例的进程发现 / 停止
│   ├── recovery_ops.py        # SSO / accounts 异步补录
│   ├── bfs_ops.py             # JWT bfs 扫描 / 面板接口
│   ├── quality_ops.py         # 降智测试任务 / 面板接口
│   └── blacklist_ops.py       # 面板黑名单接口
├── email_providers/
├── tests/                     # 结构 / 脱敏 / bfs / chdir 冒烟
├── scripts/
│   ├── check_bfs.py           # 批量 bfs 扫描
│   ├── check_quality.py       # 批量降智 / 风控实聊
│   └── …                      # xvfb 等辅助
├── config.example.json
├── proxies.example.txt
├── requirements.txt
├── AGENTS.md                  # AI 编码代理的仓库工作指南
├── DEPLOYMENT.md
├── LICENSE · NOTICE
└── README.md

参与开发或让 AI 修改仓库前，先阅读 AGENTS.md。部署细节见 DEPLOYMENT.md，发布验收见 RELEASE_CHECKLIST.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: 启动任务报 [Errno 2] No such file or directory: '/proc'？ A: 旧版面板直接读取 Linux /proc，macOS 上必然失败；更新后面板改用 psutil。若新版仍在 Linux 容器中提示无法读取进程列表，说明容器没有挂载 procfs，请恢复默认 /proc 挂载后重启面板。不要用“忽略进程检测”绕过，否则可能重复启动任务。

Q: Windows？
A: 已本机验证，CI 覆盖 Node/Xvfb 解析。不依赖 Xvfb；用 scripts\setup_windows.ps1 安装，scripts\run_windows_batch.ps1 跑批。默认 GROK_HEADLESS=1。代理必须是本机可达的 HTTP/SOCKS URL，不要沿用 Linux 上的 127.0.0.1:82xx mixed 口。详见 WINDOWS.md。

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 每日更新，不依赖第三方绘图接口。

• grok2api-egress-enhancements — grok2api 出口增强补丁：固定代理快速恢复 + 出口质量守护（被动 Token/s 熔断、硬阈值隔离、最低健康节点、管理面板）

• 介绍页 — 一页看面板、安装和声明
• Discussions — 版本公告、踩坑和想法
• 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