Public
Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md
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 开源协议 开源。