Turb GPT Register 教程：搭建本地注册流程与 WebUI

项目简介

Turb GPT Register 是一套在本机运行的注册流程工具，基于 gpt-free-register 整理和扩展。它将邮箱、代理与注册流程集中管理，既支持协议驱动方式，也可以连接本地指纹浏览器。

项目可以从命令行启动，并提供本地 WebUI，用于配置运行环境和管理任务。需要注意的是，它不会提供账号、邮箱或代理，也不能保证第三方服务始终可用。

请只在自己有权使用的环境中运行，并遵守相关服务、邮箱提供商和代理提供商的规则。

主要功能与项目结构

主要特点

• 在本机运行，配置和结果保存在本地。
• 集中管理邮箱服务、代理和注册流程。
• 支持协议驱动的注册组件。
• 可以对接本地指纹浏览器。
• 提供命令行入口和本地 WebUI。
• 将核心逻辑、配置、页面、工具和第三方组件分目录管理。

目录说明

• core/：主程序与核心逻辑。
• config/：项目配置。
• webui/：本地管理页面。
• tools/：辅助脚本。
• vendor/gpt-register-tool/协议：协议注册组件及其相关文件。

排查代码或配置问题时，可以先根据功能定位到对应目录，通常比在整个仓库中搜索更高效。

安装前准备

项目建议使用 Python 3.11。下面的安装命令适用于 Windows PowerShell，并假设你已经将仓库下载到本地。

此外，你还需要自行准备可用的邮箱服务和代理配置。如果使用浏览器驱动，还可能需要安装额外的浏览器或供应商客户端；执行 pip install 只会安装 Python 依赖，不会自动安装这些外部程序。

安装与启动

第一步：创建虚拟环境

在仓库根目录打开 PowerShell，然后创建名为 .venv 的 Python 虚拟环境：

python -m venv .venv

第二步：激活虚拟环境

.venv\Scripts\Activate.ps1

激活后，后续安装的 Python 包会被放入该项目的虚拟环境中，避免影响系统中的其他 Python 项目。

第三步：安装依赖

pip install -r requirements.txt

如果安装失败，应记录完整错误信息，并检查 Python 版本、网络环境和依赖安装日志。

第四步：创建本地配置文件

Copy-Item .env.example .env

.env.example 是配置样例。复制完成后，应编辑自己的 .env，填入实际运行环境所需的配置。

不要把真实邮箱凭据、代理密钥或其他敏感信息写回 .env.example，也不要将包含真实凭据的 .env 提交到 Git。

第五步：启动 WebUI

python web.py

程序启动后，打开本地 WebUI，根据页面提供的配置项填写自己的邮箱服务与代理信息，然后再管理相应任务。README 没有承诺固定的页面地址或字段名称，因此应以程序启动日志和当前 WebUI 页面为准。

基本使用流程

1. 确认 Python 3.11、虚拟环境和项目依赖已经准备完成。
2. 从 .env.example 创建 .env，并填写自己的运行配置。
3. 使用 python web.py 启动本地管理页面。
4. 在 WebUI 中配置自己有权使用的邮箱服务和代理。
5. 根据本地环境选择协议驱动或浏览器驱动方式。
6. 运行任务后检查结果和日志，确认邮箱、代理及驱动环节是否正常。

一个完整的 PowerShell 启动示例如下：

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
Copy-Item .env.example .env
python web.py

单独使用协议注册组件

协议注册组件位于 vendor/gpt-register-tool/协议。如果希望脱离主 WebUI 单独运行，应进入该目录，阅读组件自身的说明，并按照其中的要求安装对应依赖。

该目录中的组件可能拥有独立的上游来源、许可证和版权说明。使用前应同时查看它自己的文档与许可文件，而不是默认主项目的安装方式和许可证覆盖所有内容。

高级使用与维护建议

优先从日志和配置排查问题

注册流程依赖邮箱提供商、代理服务和浏览器环境。任何一方更改接口、出现网络波动或调整客户端行为，都可能导致流程失败。发生问题时，可以按以下顺序检查：

1. 查看完整日志，定位最先出现的错误。
2. 核对 .env 和 WebUI 中的配置。
3. 验证邮箱服务是否仍可访问。
4. 检查代理凭据、网络连通性和稳定性。
5. 如果使用浏览器驱动，确认浏览器或供应商客户端已正确安装并运行。
6. 如果使用协议组件，检查其目录中的依赖和上游说明。

保护本地运行数据

邮箱池、代理凭据、账号数据库、浏览器资料、日志和导出文件都属于本地运行数据。这些文件可能包含敏感信息，不应提交到公开或共享仓库。

虽然项目的 .gitignore 已排除常见数据文件，但提交代码前仍应主动检查待提交列表。不要仅依赖文件名或忽略规则来保护凭据。

准备有效的问题报告

如果需要向项目提交 Issue 或 Pull Request，应附上足够的诊断信息：

• 完整或关键的报错内容。
• 操作系统、Python 版本和相关运行环境。
• 可重复执行的复现步骤。
• 使用的是协议驱动还是浏览器驱动。
• 已隐藏密码、令牌和代理凭据的必要配置说明。

不要公开粘贴真实凭据。清晰的环境信息和复现步骤，通常比简单描述“不能用”更容易定位问题。

关注第三方依赖变化

邮箱接口、代理网络和浏览器供应商客户端都可能独立变化。项目将这些环节拆分为配置和驱动，便于针对自己的环境调整，但这种设计并不能消除第三方变更带来的错误。升级或修改前，建议保留当前可用配置，并分环节验证。

许可与使用边界

主项目基于 xiaoguzuiniu/gpt-free-register 改造，按照 MIT License 发布，具体内容以仓库中的 LICENSE 为准。

vendor/gpt-register-tool/协议 中的组件保留各自上游的许可证和版权说明。分发、修改或部署这些组件之前，应分别核对其许可要求。

总结

Turb GPT Register 将邮箱、代理、协议组件和浏览器驱动整合进本地工作流，并通过 WebUI 提供统一管理入口。使用时应先完成 Python 3.11 环境、依赖和 .env 配置，再根据自己的合法授权环境选择驱动方式。遇到故障时，优先检查日志、配置和第三方服务状态，同时妥善保护所有本地凭据与运行数据。