Grok-Register

Grok 免费号 注册 → OAuth → CPA 可用 JSON 二合一 CLI（Go）。

一条命令后台跑完，产物可直接导入 CPA / cliproxy 类网关。

grok start                 # 交互：数量 + 线程(1–8)
grok start -t 10 --thread 2
grok status
grok logs -f
grok stop
grok config                # 编辑 ~/.grok/config.env
grok upload                # 手动上传 CPA JSON 到 Management API

近期特性

特性	说明
协议优先 + TLS 指纹	Go `tls-client`（默认 `chrome_131`）过 CF；`CLEARANCE_MODE=auto` 失败再拉 WARP/FS
Turnstile 屏外有头	默认 `TURNSTILE_MODE=offscreen`（非真 headless，降低 600010）
Castle 空 token	当前 `castleRequestToken=""`；风控收紧后再补 offline
testmail	`EMAIL_MODE=testmail`，GitHub Student Pack 等
cf_temp_email	对接 cloudflare_temp_email 自建 Worker
全局座位上限	`done + reserved ≤ target`
CPA 上传 wait	结束前等待 Management 上传，避免进程先退出
一键安装	路径/命令名/WARP/结束停容器交互；安全同步（不再误删非空目录）
`grok stop` 停清障	`CLEARANCE_AUTO_STOP=1` 时手动 stop 也会 `docker compose stop`
grok2api 导出	`outputs/<run>/grok2api/tokens.txt` 仅 SSO token（一行一个）
OAuth 限速	全局间隔 + discovery 缓存 + rate_limited 重试

架构三腿

协议腿  gRPC 发/验码 → Server Action → SSO hop → OAuth → 探活/CPA
边缘腿  chrome_131 TLS 优先 → CF 拦再 clearance（auto）
挑战腿  Turnstile 仅 Chromium（offscreen 池 / one-shot）

冒烟（不注册账号）:

go run scripts/smoke_protocol.go
REGISTER_PROXY=http://127.0.0.1:7890 go run scripts/smoke_protocol.go

一键安装（推荐）

scripts/install.sh 自动识别平台：

平台	前提	默认安装位置
Linux（Debian/Ubuntu）	root / sudo	源码 `/opt/Grok-Register`；数据优先 `SUDO_USER` 的 `~/.grok`（非 `/root`）
macOS	已装 Homebrew + Docker Desktop（缺则提示安装命令后退出）	`~/Grok-Register`，数据 `~/.grok`，CLI `~/.local/bin`

会拉源码、编译 CLI、装 Playwright/CloakBrowser、起 clearance，并写入分区中文注释的 config.env（与 config.env.example 同模板）。

交互询问

有真实 TTY 时会依次提示：

CLI 命令名 / 源码目录 / 数据目录 / 二进制 / venv
是否启用 WARP 清障栈？ [Y]
- Y（默认）：起 Docker 清障，REGISTER_PROXY=http://127.0.0.1:40080
- N：不装清障；再问 本机 HTTP 代理端口
  - 输入如 7890 → REGISTER_PROXY=http://127.0.0.1:7890，CLEARANCE_ENABLED=0
  - 直接回车 → 直连（无代理，适合能访问 x.ai 的境外 VPS）
（WARP 时）运行结束后是否自动关闭清障容器？ [Y]
- Y（默认）：CLEARANCE_AUTO_STOP=1，结束/中断后 docker compose stop
- N：容器常开；每次 grok start 仍会检测并自动拉起未运行的栈无 TTY 的 curl|sudo bash 可能无法提问，此时：

# WARP 清障（默认）
curl -fsSL .../install.sh | sudo bash -s -- --with-warp

# 本机 Clash 等代理
curl -fsSL .../install.sh | sudo bash -s -- --no-warp --proxy-port 7890

# 境外 VPS 直连
curl -fsSL .../install.sh | sudo bash -s -- --no-warp

# 强制全默认（WARP）
curl -fsSL .../install.sh | sudo NONINTERACTIVE=1 bash

Linux 一行

curl -fsSL https://raw.githubusercontent.com/Charles-0509/Grok-Register/main/scripts/install.sh | sudo bash

项	默认
命令	`/usr/local/bin/grok`
源码	`/opt/Grok-Register`（软链 `/opt/Grok-Reg`）
数据	`sudo` 时为 `/home/<SUDO_USER>/.grok`，纯 root 为 `/root/.grok`
Python	`/opt/cloakbrowser-venv/bin/python`
mint	`/usr/local/share/grok-reg/turnstile_{mint,pool}.py`

macOS 一行

先确认：

# 1) Homebrew — 若无:
# /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 2) Docker Desktop — 若无:
# brew install --cask docker
# 打开 Docker 应用，等引擎就绪: docker info

然后（不要 sudo）：

curl -fsSL https://raw.githubusercontent.com/Charles-0509/Grok-Register/main/scripts/install.sh | bash

项	默认
命令	`~/.local/bin/grok`
源码	`~/Grok-Register`
数据	`~/.grok`
Python	`~/.local/share/cloakbrowser-venv/bin/python`
mint	`~/.local/share/grok-reg/turnstile_{mint,pool}.py`
环境	写入 `~/.zprofile` / `~/.zshrc`

缺 brew 或 Docker 时脚本会打印安装命令并退出，装好后重跑同一行即可。

自定义命令名 / 目录

# Linux：改命令名
curl -fsSL .../install.sh | sudo bash -s -- --command grok-reg

# Linux：自定义目录
curl -fsSL .../install.sh | sudo bash -s -- \
  --install-dir /data/Grok-Register --home /data/grok-data

# macOS：改命令名 / 把二进制装到 brew 前缀
curl -fsSL .../install.sh | bash -s -- --command grok-reg
curl -fsSL .../install.sh | bash -s -- --bin-dir "$(brew --prefix)/bin"

常用选项

选项 / 环境变量	Linux 默认	macOS 默认	说明
`--command`	`grok`	同左	CLI 命令名
`--install-dir`	`/opt/Grok-Register`	`~/Grok-Register`	源码
`--home`	`/root/.grok`	`~/.grok`	数据
`--bin-dir`	`/usr/local/bin`	`~/.local/bin`	二进制
`--share-dir`	`/usr/local/share/grok-reg`	`~/.local/share/grok-reg`	mint 脚本
`--venv-dir`	`/opt/cloakbrowser-venv`	`~/.local/share/cloakbrowser-venv`	Python venv
`--skip-docker`	off	off	不检查/不装 Docker
`--skip-clearance`	off	off	不起清障
`--skip-browser`	off	off	不装 Playwright
`--skip-go`	off	off	不自动装 Go
`--no-start-clearance`	off	off	不 `compose up`

本地已 clone：

# Linux
sudo bash scripts/install.sh --command grok-reg
# macOS
bash scripts/install.sh --command grok-reg
# 或仅装二进制
make build && sudo make install          # Linux
make build && make install PREFIX="$HOME/.local" APP=grok

装完立刻跑

# Linux
export GROK_HOME=/root/.grok
export GROK_PYTHON=/opt/cloakbrowser-venv/bin/python

# macOS（或新开终端，已写进 zprofile）
export PATH="$PATH:$HOME/.local/bin"
export GROK_HOME="$HOME/.grok"
export GROK_PYTHON="$HOME/.local/share/cloakbrowser-venv/bin/python"

grok start
grok status
grok logs -f

clearance：

# Linux
cd /opt/Grok-Register/clearance && docker compose up -d && docker compose ps
# macOS
cd ~/Grok-Register/clearance && docker compose up -d && docker compose ps

系统要求

组件	用途	不装会怎样
Go 1.21+	仅编译 CLI	无法 build
Python 3.10+ + venv	Turnstile Playwright mint	拿不到 token
Playwright + CloakBrowser	无头过 CF Turnstile	`timeout` / `iframes=0`
Docker	清障栈（强烈推荐）	注册/邮箱/CF 更容易挂
CPA Management（可选）	`grok upload` / 自动上传	本地仍有 `CPA/*.json`

完整部署（手动分步）

一键脚本失败或需精细控制时使用。目标：系统依赖 → Go → Docker → 编译 → 无头浏览器 → 清障 → 配置 → 跑注册。

0. 系统依赖

sudo apt update
sudo apt install -y \
  git curl ca-certificates gnupg lsb-release \
  build-essential make \
  python3 python3-pip python3-venv \
  libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 libcups2 \
  libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 \
  libxrandr2 libgbm1 libasound2t64 libpango-1.0-0 libcairo2 \
  fonts-liberation fonts-noto-cjk

若 libasound2t64 不存在，改成 libasound2。

1. 安装 Go（仅编译需要，建议 1.21+）

cd /tmp
curl -fsSL -o go.tgz https://go.dev/dl/go1.24.4.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go.tgz
echo 'export PATH=$PATH:/usr/local/go/bin' | sudo tee /etc/profile.d/go.sh
export PATH=$PATH:/usr/local/go/bin
go version

2. 安装 Docker（清障栈用）

curl -fsSL https://get.docker.com | sudo sh
sudo systemctl enable --now docker
docker compose version || sudo apt install -y docker-compose-plugin

3. 拉取并编译安装

sudo mkdir -p /opt
cd /opt
sudo git clone https://github.com/Charles-0509/Grok-Register.git
cd /opt/Grok-Register

export PATH=$PATH:/usr/local/go/bin
make build
sudo make install
# 自定义命令名：
# make build APP=grok-reg && sudo make install APP=grok-reg

grok help

sudo make install 在已有 bin/grok 时不会再调 go（避免 root PATH 里没有 go）。

4. 无头浏览器：Playwright + CloakBrowser（必做）

sudo python3 -m venv /opt/cloakbrowser-venv
sudo /opt/cloakbrowser-venv/bin/pip install -U pip
sudo /opt/cloakbrowser-venv/bin/pip install -r /opt/Grok-Register/scripts/requirements-turnstile.txt
sudo /opt/cloakbrowser-venv/bin/python -m cloakbrowser install

echo 'export GROK_PYTHON=/opt/cloakbrowser-venv/bin/python' | sudo tee -a /root/.bashrc
echo 'export CLOAKBROWSER_SUPPRESS_FONT_WARNING=1' | sudo tee -a /root/.bashrc
export GROK_PYTHON=/opt/cloakbrowser-venv/bin/python
export CLOAKBROWSER_SUPPRESS_FONT_WARNING=1

冒烟测试（清障栈起来后）：

export GROK_PYTHON=/opt/cloakbrowser-venv/bin/python
$GROK_PYTHON /usr/local/share/grok-reg/turnstile_mint.py \
  --site-key 0x4AAAAAAAhr9JGVDZbrZOo0 \
  --url https://accounts.x.ai/sign-up \
  --proxy http://127.0.0.1:40080 \
  --timeout 70
echo exit:$?

5. 清障栈

cd /opt/Grok-Register/clearance
sudo docker compose up -d
sudo docker compose ps

端口	服务
`127.0.0.1:40000`	WARP SOCKS5
`127.0.0.1:40080`	Privoxy HTTP
`127.0.0.1:8191`	FlareSolverr

6. 配置 `~/.grok/config.env`

sudo mkdir -p /root/.grok
# 也可：grok config（首次会生成 example + 可编辑）
sudo tee /root/.grok/config.env >/dev/null <<'EOF'
EMAIL_MODE=tempmail

CLEARANCE_ENABLED=1
REGISTER_PROXY=http://127.0.0.1:40080
FLARESOLVERR_URL=http://127.0.0.1:8191
CLEARANCE_PROXY=http://privoxy:8118
CLEARANCE_URLS=https://accounts.x.ai,https://x.ai,https://status.x.ai,https://console.x.ai,https://auth.x.ai

TURNSTILE_PROVIDER=browser

PROTOCOL_HTTP=1
HTTP_POOL_SIZE=8
TEMPMAIL_LOL_RETRIES=30
TEMPMAIL_LOL_MIN_INTERVAL_MS=1500

HTTPS_PROXY=http://127.0.0.1:40080
HTTP_PROXY=http://127.0.0.1:40080
NO_PROXY=127.0.0.1,localhost

PROBE_ENABLED=1

CPA_UPLOAD_ENABLED=0
CPA_MANAGEMENT_BASE=http://127.0.0.1:8317/v0/management
CPA_MANAGEMENT_KEY=
CPA_UPLOAD_TIMEOUT_SEC=30
CPA_UPLOAD_RETRIES=2
CPA_UPLOAD_NAME_TEMPLATE={email}.json
EOF

邮箱模式：

# 1) 公共临时邮箱（默认，无需 token）
EMAIL_MODE=tempmail

# 2) testmail.app
# EMAIL_MODE=testmail
# TESTMAIL_API_KEY=你的_apikey
# TESTMAIL_NAMESPACE=你的_namespace
# TESTMAIL_DOMAIN=inbox.testmail.app

# 3) 自建域名 webhook（Email Routing + 本地 webhook）
# EMAIL_MODE=custom
# EMAIL_DOMAIN=example.com
# EMAIL_API=http://127.0.0.1:8080

# 4) cloudflare_temp_email 自建 Worker
#    https://github.com/dreamhunter2333/cloudflare_temp_email
# EMAIL_MODE=cf_temp_email
# CF_TEMP_EMAIL_API=https://mail-api.example.com
# CF_TEMP_EMAIL_ADMIN=你的_admin_密码
# CF_TEMP_EMAIL_DOMAIN=              # 可选；留空=Worker 已配置域名随机/默认
# CF_TEMP_EMAIL_AUTH=                # 可选 x-custom-auth
# CF_TEMP_EMAIL_PREFIX=1

tempmail = tempmail.lol + mail.tm 系 fallback，无需私人 Token。
testmail 密钥只写本地 config.env，勿提交仓库。
cf_temp_email 对接 cloudflare_temp_email：用 admin 建号 POST /admin/new_address（x-admin-auth）拿地址 JWT，再 GET /api/parsed_mails 收信抽验证码；旧部署无 parsed_mails 时自动回退 /api/mails。
CF_TEMP_EMAIL_DOMAIN 可选：不填则请求不带 domain，由 Worker 按自身 DOMAINS/DEFAULT_DOMAINS 随机或取默认；填了则固定该后缀。别名：cf_temp / cftemp。

7. 启动与运维

export GROK_PYTHON=/opt/cloakbrowser-venv/bin/python
export CLOAKBROWSER_SUPPRESS_FONT_WARNING=1

grok start
grok start -t 10 --thread 3
grok status
grok logs -f
grok stop
grok config
grok upload

数据目录（GROK_HOME，默认 ~/.grok）：

~/.grok/
├── config.env / config.env.example
├── run.pid / run.lock / state.json
├── logs/run-yyyymmdd-HHMMSS.log
└── outputs/<run_id>/
    ├── SSO/                 # email:password:sso
    ├── CPA/                 # 探活成功 JSON（cliproxy/CPA）
    ├── grok2api/tokens.txt  # 仅 SSO token，一行一个
    └── discarded/

8. 更新

# 推荐：重跑一键（保留 config.env，自动补齐新键）
curl -fsSL https://raw.githubusercontent.com/Charles-0509/Grok-Register/main/scripts/install.sh | sudo bash

# 或手动
cd /opt/Grok-Register   # mac: ~/Grok-Register
sudo git pull
export PATH=$PATH:/usr/local/go/bin
make build && sudo make install   # mac: make install PREFIX=$HOME/.local
# Linux 无头服务器 Turnstile:
sudo apt-get install -y xvfb

macOS 备注

推荐一键：先装 Homebrew + Docker Desktop，再 curl .../install.sh | bash（见上文）
手动：brew install go python，venv + CloakBrowser，make build && make install PREFIX=$HOME/.local
清障：打开 Docker Desktop 后 cd ~/Grok-Register/clearance && docker compose up -d

Windows / Docker Desktop（推荐路径）

grok 二进制不能在 Windows 原生编译（internal/daemon/daemon.go 用 syscall.Flock / Setsid / SIGTERM/SIGKILL，Windows 没有 POSIX 信号）。用 Docker Desktop 跑容器镜像即可，所有 Unix 调用都在 linux/amd64 容器内执行，host 完全不参与。

仓库根有现成的 Dockerfile + docker-compose.yml，整合了：

Go 编译的 grok 二进制
Python venv + Playwright + CloakBrowser Chromium
clearance 栈（WARP SOCKS5 + Privoxy HTTP + FlareSolverr）
grok 应用容器

# 1) 起栈（首次构建镜像 + 拉取 3 个 clearance 镜像；耐心等几分钟）
docker compose up -d --build
docker compose ps
# 期望：warp / privoxy / flaresolverr healthy，grok-reg Up

# 2) 进入交互 — 与 Linux 完全一致
docker exec -it grok-reg grok help
docker exec -it grok-reg grok start -t 10
docker exec -it grok-reg grok status
docker exec -it grok-reg grok logs -f
docker exec -it grok-reg grok stop

输出文件：宿主机可直接看到 ./data/（Windows 资源管理器 Grok-Register\data）：

data/config.env — 首次启动从 docker/grok-config.env 拷过去；可手动改后 docker compose restart grok
data/outputs/<run_id>/CPA/*.json — 注册成功可直接拖入 CPA Management
data/outputs/<run_id>/SSO/accounts.txt — SSO 明细
data/logs/run-*.log — 完整日志

一次性前台跑一批（跑完即停、不残留）：

docker compose run --rm -e GROK_TARGET=20 grok run

冒烟测试（确认 CloakBrowser 在容器里能拿 token）：

docker exec -it grok-reg sh
# 容器内：
/opt/cloakbrowser-venv/bin/python /usr/local/share/grok-reg/turnstile_mint.py \
  --site-key 0x4AAAAAAAhr9JGVDZbrZOo0 \
  --url https://accounts.x.ai/sign-up \
  --proxy http://privoxy:8118 \
  --timeout 70
echo exit:$?

关键约定（与 Linux 裸跑差异）：

项	Linux 裸跑	Docker Desktop Windows
`REGISTER_PROXY`	`http://127.0.0.1:40080`	`http://privoxy:8118`
`FLARESOLVERR_URL`	`http://127.0.0.1:8191`	`http://flaresolverr:8191`
`CLEARANCE_PROXY`	`http://privoxy:8118`	`http://privoxy:8118`
Chrome 路径	`~/.cloakbrowser/...`	`/root/.cloakbrowser/...`（容器内 root）
`GROK_HOME`	`~/.grok`	`/data`（=`host ./data`）
`CPA_MANAGEMENT_BASE`	`http://127.0.0.1:8317/...`	`http://host.docker.internal:8317/...`

docker/grok-config.env 已写好上述约定，默认即用；如要改自覆写 data/config.env。

升级镜像：

git pull
docker compose build grok
docker compose up -d --force-recreate grok

清理（保留 ./data）：

docker compose down           # 停容器
docker compose down -v        # 同时删 network
Remove-Item -Recurse bin/,, data/ -ErrorAction SilentlyContinue   # 连本地输出一起删

命令一览

命令	说明
`grok start`	交互：注册数量 + 并发线程(1–8)
`grok start -t N --thread M`	目标 N（1–10000）；线程 M（1–8）；计数 = CPA 探活成功数
`grok status`	进度、线程、当前步骤
`grok logs` / `logs -f`	最近日志 / 跟踪
`grok stop`	停止注册机；`CLEARANCE_AUTO_STOP=1` 时同步停清障容器
`grok config`	打开 `config.env`，刷新 `config.env.example`
`grok upload`	选最近 run，上传 CPA JSON

配置补充

变量	说明
`GROK_HOME`	数据根，默认 `~/.grok`
`GROK_PYTHON`	mint/pool 用的 Python
`GROK_TURNSTILE_SCRIPT`	one-shot mint 路径
`GROK_TURNSTILE_POOL_SCRIPT`	常驻池路径
`CHROME_PATH`	强制 Chromium
`CLOAKBROWSER_SUPPRESS_FONT_WARNING`	抑制 Linux 字体提示
`EDITOR`	`grok config` 编辑器

完整模板：~/.grok/config.env.example（每次 start/config 同步）。

流水线

清障预热 → S:Turnstile → P:邮箱+验证码 → C:注册拿 SSO
       → OAuth → 整备 CPA JSON → 探活 → 写 CPA/
       → (可选) 异步上传 Management API

TARGET：仅 CPA/ 探活成功数
座位：done + reserved ≤ target（全局，非每线程）
自动上传失败不影响记成功

边缘 / 清障

CF_IMPERSONATE=chrome_131
CF_IMPERSONATE_FALLBACK=chrome_124,chrome_120
CLEARANCE_MODE=auto    # auto | always | never
CLEARANCE_ENABLED=1
CLEARANCE_AUTO_STOP=1

CLEARANCE_MODE	行为
auto（默认）	先 TLS 指纹 warm；403/拦再 `docker compose up` + 预热
always	启动即清障
never	不碰 Docker 清障（靠直连/自有代理）

Turnstile

默认 browser + TURNSTILE_MODE=offscreen：

常驻池 turnstile_pool.py（屏外有头）
回退 one-shot turnstile_mint.py
再回退 chromedp 真 headless（不推荐，易 600010）

TURNSTILE_PROVIDER=browser
TURNSTILE_MODE=offscreen   # offscreen | headless | auto

默认不注入 FlareSolverr cookie/UA（除非 GROK_TURNSTILE_INJECT_CLEARANCE=1）。

可选 lite farm：

TURNSTILE_PROVIDER=lite
LITE_SOLVER_URL=http://127.0.0.1:5072

代理：WARP vs HTTP 池

	WARP + Privoxy（默认）	HTTP 代理池
成本	低	按量
适合	个人小批量	冲量 / 多 IP
配置	本机 compose	池 + 轮换

CPA 上传

CPA_UPLOAD_ENABLED=1
CPA_MANAGEMENT_BASE=http://127.0.0.1:8317/v0/management
CPA_MANAGEMENT_KEY=...

宿主机跑 grok 必须用 127.0.0.1，不要写 cli-proxy-api
新版本会自动改写 docker 主机名并补 /v0/management
手动：grok upload

目录结构

Grok-Register/
├── cmd/grok/
├── internal/
├── scripts/
│   ├── install.sh            # 一键部署
│   ├── turnstile_mint.py
│   ├── turnstile_pool.py
│   └── requirements-turnstile.txt
├── clearance/                # docker compose 清障
├── cloudflare/email-worker.js
├── Makefile                  # APP= 可改命令名
└── README.md

常见问题

一键装完命令找不到

export PATH=$PATH:/usr/local/bin
# 或重新登录 shell；见 /etc/profile.d/grok-register.sh

make build go not found

export PATH=$PATH:/usr/local/go/bin
make build && sudo make install

turnstile timeout / iframes=0

GROK_PYTHON 指向已装 playwright 的 venv
python -m cloakbrowser install 已完成
clearance healthy，REGISTER_PROXY 可用

lookup cli-proxy-api: no such host

CPA_MANAGEMENT_BASE=http://127.0.0.1:8317/v0/management

邮箱建得特别多

请更新到含全局 reserved 座位上限的版本。

更新日志（近期）

2026-07 · OAuth / 运维 / 导出

OAuth：全局启动间隔（默认 4s）、OIDC discovery 缓存、rate_limited 自动重试一次；高并发默认 1 个 OAuth worker
探活：PROBE_WARMUP_SEC 默认 5s；403/5xx 多轮退避重试
grok stop：在 CLEARANCE_AUTO_STOP=1 时同步 docker compose stop 清障栈（以前只有达目标/正常结束才停）
安装安全：非默认 INSTALL_DIR 且无 .git 时不再 rm -rf 整目录；危险/非空非本仓目录直接拒绝
grok2api：outputs/<run>/grok2api/tokens.txt 仅 SSO token，一行一个
一键安装：Linux 默认装 xvfb；种子/升级合并 TURNSTILE_MODE=offscreen、CF_IMPERSONATE、OAUTH_*、PROBE_WARMUP_SEC 等

更早（协议优先批次）

TLS chrome_131 + CLEARANCE_MODE=auto|always|never
Turnstile offscreen（有 $DISPLAY/xvfb-run 时有头屏外；无显示则 headless 回退）
CPA Management 上传结束前等待；座位 done+reserved≤target
分区中文 config.env 模板；交互 WARP/代理/自动停容器

旧版本升级（命令集合）

Linux（Debian/Ubuntu）

# 1) 系统包（无头 Turnstile 需要 xvfb）
sudo apt-get update -y
sudo apt-get install -y xvfb

# 2) 更新源码 + 重装 CLI（推荐重跑一键，会保留 config 并补齐新键）
curl -fsSL https://raw.githubusercontent.com/Charles-0509/Grok-Register/main/scripts/install.sh | sudo bash

# 或手动:
#   cd /opt/Grok-Register && sudo git pull
#   export PATH=$PATH:/usr/local/go/bin
#   make build && sudo make install

# 3) 若未跑一键 merge，手工补 config（路径按你的 GROK_HOME）
CFG="${GROK_HOME:-$HOME/.grok}/config.env"
# root 安装时常是 /home/<用户>/.grok
grep -q '^CLEARANCE_MODE=' "$CFG" 2>/dev/null || echo 'CLEARANCE_MODE=auto' >>"$CFG"
grep -q '^CLEARANCE_AUTO_STOP=' "$CFG" 2>/dev/null || echo 'CLEARANCE_AUTO_STOP=1' >>"$CFG"
grep -q '^CF_IMPERSONATE=' "$CFG" 2>/dev/null || echo 'CF_IMPERSONATE=chrome_131' >>"$CFG"
grep -q '^CF_IMPERSONATE_FALLBACK=' "$CFG" 2>/dev/null || echo 'CF_IMPERSONATE_FALLBACK=chrome_124,chrome_120' >>"$CFG"
grep -q '^TURNSTILE_MODE=' "$CFG" 2>/dev/null || echo 'TURNSTILE_MODE=offscreen' >>"$CFG"
grep -q '^OAUTH_MIN_INTERVAL_SEC=' "$CFG" 2>/dev/null || echo 'OAUTH_MIN_INTERVAL_SEC=6' >>"$CFG"
grep -q '^OAUTH_RETRY_SEC=' "$CFG" 2>/dev/null || echo 'OAUTH_RETRY_SEC=60' >>"$CFG"
grep -q '^PROBE_WARMUP_SEC=' "$CFG" 2>/dev/null || echo 'PROBE_WARMUP_SEC=5' >>"$CFG"

# 4) 验证
which grok; grok help
command -v xvfb-run && xvfb-run -a echo xvfb_ok

macOS

# 1) 依赖（一般无需 xvfb；Docker Desktop 保持运行）
brew install go python 2>/dev/null || true

# 2) 一键或手动
curl -fsSL https://raw.githubusercontent.com/Charles-0509/Grok-Register/main/scripts/install.sh | bash
# 或: cd ~/Grok-Register && git pull && make build && make install PREFIX=$HOME/.local

# 3) 补 config（同 Linux，CFG=~/.grok/config.env）
CFG="${GROK_HOME:-$HOME/.grok}/config.env"
grep -q '^OAUTH_MIN_INTERVAL_SEC=' "$CFG" 2>/dev/null || echo 'OAUTH_MIN_INTERVAL_SEC=6' >>"$CFG"
grep -q '^OAUTH_RETRY_SEC=' "$CFG" 2>/dev/null || echo 'OAUTH_RETRY_SEC=60' >>"$CFG"
grep -q '^PROBE_WARMUP_SEC=' "$CFG" 2>/dev/null || echo 'PROBE_WARMUP_SEC=5' >>"$CFG"
grep -q '^TURNSTILE_MODE=' "$CFG" 2>/dev/null || echo 'TURNSTILE_MODE=offscreen' >>"$CFG"
grep -q '^CLEARANCE_AUTO_STOP=' "$CFG" 2>/dev/null || echo 'CLEARANCE_AUTO_STOP=1' >>"$CFG"

默认节奏（新装/代码 Defaults）：OAUTH_MIN_INTERVAL_SEC=6、PROBE_WARMUP_SEC=5、OAUTH_RETRY_SEC=60；交互线程回车=2。仍 429 可再把间隔调到 8。

开发

go test ./...
go build -o bin/grok ./cmd/grok
bash -n scripts/install.sh

License

MIT（与上游 grok-free-register 思路一致；本仓库为 Go 重制版。）

友链

LinuxDo · Charles0509

场景	内存	CPU	说明
最低能跑	2 GiB + 2 GiB swap	1–2 vCPU	仅 `--thread 1`；清障 + 1 个 Chromium
舒适	4 GiB	2–4 vCPU	`--thread 1~2`
冲量	8 GiB+	4+ vCPU	`--thread 3~4`（再高收益有限）

组件	约占用
WARP + Privoxy + FlareSolverr	400–900 MiB
CloakBrowser / Chromium（1 个）	300–800 MiB
grok CLI + Python mint	50–150 MiB
系统 / Docker 开销	200–400 MiB
合计	约 1.2–2.5 GiB 峰值

Name		Name	Last commit message	Last commit date
Latest commit History 43 Commits
clearance		clearance
cloudflare		cloudflare
cmd/grok		cmd/grok
docker		docker
internal		internal
scripts		scripts
.gitignore		.gitignore
Dockerfile		Dockerfile
Makefile		Makefile
README.md		README.md
config.env.example		config.env.example
docker-compose.yml		docker-compose.yml
go.mod		go.mod
go.sum		go.sum

Folders and files

Latest commit

History

Repository files navigation