grok-reg-tool

grok-reg-tool

grok-reg-tool 是一个可自部署的 Grok 注册机 Web 控制台，支持 Docker 一键构建、DrissionPage 自动化注册、邮件验证码读取、SSO 输出和本地账号号池管理。

适合搜索的关键词：Grok 注册机、Grok 自动注册、Grok Web 控制台、Grok 账号号池、Grok SSO、xAI 自动化、DrissionPage 自动化、Docker 自部署注册工具。

本项目与 xAI、Grok、X 没有官方关联。请仅在合法、合规、获得许可的研究、学习或自托管实验环境中使用。

功能

• Web 控制台：启动、停止、查看注册任务和实时日志。
• 内置注册机：Python 注册脚本已放在 register/，Docker 构建时自动安装依赖。
• 邮件后端：支持对接 cloudflare_temp_email 读取验证码。
• 号池管理：本地保存账号记录和 SSO 输出。
• Docker 部署：运行数据默认保存到 docker/data/。

快速部署

git clone https://github.com/FengZi1221/grok-reg-tool.git
cd grok-reg-tool/docker
cp .env.example .env

编辑 docker/.env：

WEB_PORT=6657
RUN_COUNT=10

MAIL_API_BASE=
MAIL_ADMIN_AUTH=
MAIL_DOMAIN=

HTTP_PROXY=
BROWSER_PROXY=
COOKIE_SECURE=

启动：

docker compose up -d --build

访问：

http://你的服务器IP:6657

初始 Web 登录信息：

docker logs grok-reg-tool

首次登录后请修改默认用户名和密码。

直接用 http://服务器IP:6657 访问时，COOKIE_SECURE 请留空。只有放在 HTTPS 反向代理后面时，才建议设置 COOKIE_SECURE=1。

邮件后端配置

本项目推荐对接 dreamhunter2333/cloudflare_temp_email。

请先按它的官方文档部署好 Cloudflare 临时邮箱服务。本 README 不重复它的部署教程，只说明本项目要填哪些值：

配置项	填写内容
MAIL_API_BASE	cloudflare_temp_email 的后端 Worker/API 根地址
MAIL_ADMIN_AUTH	cloudflare_temp_email 的网站 admin 密码，会作为 x-admin-auth 使用
MAIL_DOMAIN	已在 cloudflare_temp_email 中配置并可收信的域名

调用关系很简单：本项目会请求 MAIL_API_BASE + /admin/new_address 创建邮箱，再用返回的 jwt 轮询邮件并提取验证码。

常用路径

用途	路径
容器内注册脚本	/app/register
Python 入口	/app/register/runner.py
容器内数据目录	/data
宿主机数据目录	docker/data
SSO 输出	docker/data/sso

本地开发

npm install
npm run server:build
npm run server:dev

本地运行 Python 注册入口：

python -m pip install -r register/requirements.txt
python register/runner.py --count 1

注意事项

• 不要提交 .env、docker/.env、docker/data/、SSO token、邮件凭据或代理密钥。
• 如果部署到公网，请设置强密码并限制访问来源。
• 使用前请确认目标平台条款和所在地法律法规。

致谢

• 感谢 ReinerBRO/grok-register，本项目的自动化注册思路和 Python 注册流程受其启发。
• 感谢 dreamhunter2333/cloudflare_temp_email，本项目默认面向该邮件后端适配验证码读取流程。

开源协议

本项目基于 MIT 开源协议 开源。