项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- Python 3.10+(README 示例使用 python3.12 创建虚拟环境)
- Node.js(安装后需能执行 node --version)
- 使用 Roxy 驱动时需本机运行 RoxyBrowser(默认 API 地址 http://127.0.0.1:50100)
- 需要自备邮箱源、代理池,以及按需的接码/云端浏览器服务账号
安装与启动步骤
-
1获取项目源码
从 GitHub 克隆仓库并进入项目根目录,后续所有命令都在该目录执行。
git clone https://github.com/myfanhua/turb-gpt-free-register.git cd turb-gpt-free-register -
2创建虚拟环境
README 明确建议使用项目虚拟环境,不要直接使用系统 pip 安装依赖。
python3 -m venv .venv -
3安装 Python 依赖
先升级 pip,再按 requirements.txt 安装依赖;Cloak 驱动同样走这一步安装。
.venv/bin/python -m pip install --upgrade pip .venv/bin/python -m pip install -r requirements.txt -
4检查 Node 环境
README 要求确认 Node 可用,执行后应输出具体版本号。
node --version -
5复制密钥配置
重要 API Key 请放在项目根目录的 .env,不要写进 config/*.py。
cp .env.example .env -
6配置驱动与资源
编辑 config/roxybrowser.py 等文件或 WebUI 配置页,设置注册驱动、邮箱源、代理池与 Codex 授权。
-
7启动 WebUI
README 推荐日常使用 WebUI;webui.sh 会优先使用 .venv/bin/python。用 ./webui.sh start 启动。
./webui.sh start -
8或使用 CLI 注册
不启动 WebUI 时可直接用 CLI,-n 为注册数量,--workers 为并发线程数,可加 --verbose 看详细日志。
python main.py -n 10 --workers 3 --continue-on-fail
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
REGISTRATION_DRIVER | 是 | 选择注册驱动,决定用协议还是各类浏览器方案注册 | roxy |
ROXY_API_BASE | 否 | RoxyBrowser 本地 API 地址,使用 roxy 驱动时需要 | http://127.0.0.1:50100 |
ROXY_API_TOKEN | 否 | RoxyBrowser 的 API Key,使用 roxy 驱动时需要 | 你的Roxy API Key |
PROXY_POOL | 否 | 代理池列表,Roxy 一号一环境会从中随机取代理 | ["http://user:pass@host:port"] |
ENABLE_CODEX_AUTO | 否 | 注册成功后是否自动执行 Codex OAuth 授权 | True |
BROWSER_USE_API_KEY | 否 | 使用 browser_use 云端浏览器驱动时填写的 API Key | 你的 Browser Use API Key |
如何确认成功
执行 .venv/bin/python -c 'import sys, flask; print(sys.executable); print(flask.__version__)' 能打印解释器路径与 Flask 版本,且 ./webui
常见问题
Q:配置保存后没生效怎么办?
A:WebUI 配置页保存后会热加载;直接手改 config/*.py 时 CLI 进程需重启,WebUI 建议统一在配置页修改。
Q:macOS 升级后 .venv 里的 Python 失效怎么办?
A:删除旧环境后用当前已安装的 Python 3.10+ 重建:rm -rf .venv、python3.12 -m venv .venv,再重装 requirements.txt 并重启 WebUI。
Q:注册过程中页面出错怎么排查?
A:临时设置 ROXY_KEEP_BROWSER_OPEN = True、ROXY_OPEN_HEADLESS = False 保留浏览器观察,调试完再改回自动关闭/删除环境。
Q:可以同时开多个 CLI 进程批量跑吗?
A:不建议。README 建议日常批量使用 WebUI,并且注册线程数不要超过可用代理数量。
注意事项
- 重要 API Key 放在项目根目录 .env,不要写进 config/*.py。
- 注册线程数建议不超过可用代理数;Roxy 一号一环境建议保持开启以降低环境污染。
- Roxy 无头运行可设置 ROXY_OPEN_HEADLESS = True。
- 仓库只含源码、配置模板和文档,运行时账号、Token、邮箱池、Codex 凭证与日志均被排除,需自行准备邮箱、代理、接码等资源。
核心亮点
- 同时支持指纹浏览器和纯协议两种注册模式,适配不同风控强度
- 自动完成邮箱验证码与短信接码,减少人工介入
- 集成 Codex 授权与提链服务器对接,注册后可直接投入使用
不足之处
- 依赖第三方接码与代理服务,实际可用性受外部资源影响
- 自动化注册行为可能违反目标平台服务条款,存在封号风险
适用场景
- 需要批量账号做 API 或模型对比测试的开发者
- 研究自动化注册流程与反爬对抗的技术人员
- 搭建账号池用于内部工具调用的团队
替代项目
browser-use、playwright
上一篇:cc-connect
下一篇:machinist
同类项目推荐
n8n
开源
拖拽搭建自动化流程,轻松接入 AI 与 400+ 应用,搞定重复工作。
Fair-code workflow automation platform with native AI capabilities. Combine visual b···
EasyCLIProxyAPI
开源
图形界面一键配好 AI 代理,省去手写配置文件
A desktop GUI for CLIProxyAPI and a tool for automatically configuring popular AI ag···
feishu-docx
开源
让 AI 代理轻松读写飞书文档,双向转换 Markdown
Feishu/Lark Docs、Sheet、Bitable <-> Markdown | AI Agent-friendly knowledge base exp···
puppeteer
开源
用 JavaScript 轻松操控无头浏览器,搞定自动化测试与网页抓取。
JavaScript API for Chrome and Firefox
