🚀 OpenAI Team Auto Provisioner
OpenAI Team 账号自动批量注册 & 授权入库工具
✨ 功能特性
- 🔄 全自动化流程 - 从邮箱创建到授权入库一键完成
- 📧 多邮箱系统支持 - 支持 Cloud Mail 自建邮箱和 GPTMail 临时邮箱
- 👥 Team 批量邀请 - 一次性邀请多个账号到 Team
- 🌐 浏览器自动化 - 基于 DrissionPage 的智能注册
- 🔐 多授权服务支持 - 支持 CRS / CPA / S2A 三种授权入库方式
- 💾 断点续传 - 支持中断恢复，避免重复操作
- 📊 状态追踪 - 详细的账号状态记录与追踪
- 🌍 代理轮换 - 支持多代理配置和自动轮换
- 🎭 浏览器指纹 - 随机浏览器指纹防检测
📋 前置要求
- Python 3.12+
- uv (推荐) 或 pip
- Chrome 浏览器
- 邮箱服务 API
- 授权服务 API (CRS / CPA / S2A 任选其一)
🛠️ 快速开始
1. 安装依赖
# 使用 uv (推荐)
uv sync
# 或使用 pip
pip install -r requirements.txt
2. 配置文件
# 复制配置模板
cp config.toml.example config.toml
cp team.json.example team.json
3. 编辑配置
config.toml - 主配置文件
# ==================== 服务选择 ====================
# 邮箱系统: "cloudmail" (自建邮箱) 或 "gptmail" (临时邮箱)
email_provider = "gptmail"
# 授权服务: "crs" / "cpa" / "s2a"
auth_provider = "cpa"
# 是否将 Team Owner 也添加到授权服务入库
# - true: Owner 账号也会进行授权并入库 (需要 Owner 邮箱能接收验证码)
# - false: 仅处理邀请的成员账号，Owner 不入库
include_team_owners = false
# ==================== 邮箱服务配置 ====================
# Cloud Mail 邮箱服务 (email_provider = "cloudmail" 时使用)
[email]
api_base = "https://your-email-service.com/api/public"
api_auth = "your-api-auth-token"
domains = ["domain1.com", "domain2.com"]
role = "gpt-team"
web_url = "https://your-email-service.com"
# GPTMail 临时邮箱 (email_provider = "gptmail" 时使用)
[gptmail]
api_base = "https://mail.chatgpt.org.uk"
api_key = "gpt-test"
prefix = "" # 邮箱前缀，留空自动生成
domains = [] # 可用域名列表，留空使用默认
# ==================== 授权服务配置 ====================
# CRS 服务配置 (auth_provider = "crs" 时使用)
[crs]
api_base = "https://your-crs-service.com"
admin_token = "your-admin-token"
# CPA 服务 (auth_provider = "cpa" 时使用)
[cpa]
api_base = "http://your-cpa-service:8317"
admin_password = "your-admin-password"
poll_interval = 2 # 轮询间隔 (秒)
poll_max_retries = 30 # 最大重试次数
is_webui = true
# S2A 服务 (auth_provider = "s2a" 时使用)
[s2a]
api_base = "https://your-sub2api-service.com/api/v1"
admin_key = "your-admin-api-key" # Admin API Key (推荐)
admin_token = "" # JWT Token (备选)
concurrency = 10 # 账号并发数
priority = 50 # 账号优先级
group_ids = [] # 分组 ID 列表
group_names = ["codex"] # 分组名称列表 (自动解析为 ID)
# ==================== 账号配置 ====================
[account]
default_password = "YourSecurePassword@2025"
accounts_per_team = 4
# ==================== 浏览器配置 ====================
[browser]
wait_timeout = 60
short_wait = 10
headless = false # 无头模式
# ==================== 代理配置 (可选) ====================
proxy_enabled = false
# [[proxies]]
# type = "socks5"
# host = "127.0.0.1"
# port = 1080
# 更多配置项请参考 config.toml.example
team.json - Team 凭证配置
💡 通过访问
https://chatgpt.com/api/auth/session获取（需先登录 ChatGPT）
格式 1: 旧格式 (完整 Session)
[
{
"user": { "email": "team-admin@example.com" },
"account": {
"id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"organizationId": "org-xxxxxxxxxxxxxxxxxxxxxxxx"
},
"accessToken": "eyJhbGciOiJSUzI1NiIs..."
}
]
⚠️ 注意: 格式 1 的 Team Owner 邮箱必须是自己可控的域名邮箱，才能接收验证码完成授权入库。如果是第三方邮箱（如 Gmail），Owner 账号无法入库，只能邀请成员账号。
格式 2: 新格式 (邮箱密码 + Token)
[
{
"account": "team-admin@example.com",
"password": "your-password",
"token": "eyJhbGciOiJSUzI1NiIs..."
}
]
格式 3: 新格式 (仅邮箱密码，自动登录获取 Token)
[
{
"account": "team-admin@example.com",
"password": "your-password"
}
]
💡 格式 3 无需提供 Token，程序会自动登录获取并保存到配置文件
三种格式的处理策略
| 格式 | Owner 授权入库 | 成员邀请 | Token 获取 | 适用场景 |
|---|---|---|---|---|
| 格式 1 | ⚠️ 需自有域名邮箱 | ✅ 支持 | 手动提供 | 已有 Session，Owner 用第三方邮箱 |
| 格式 2 | ✅ 支持 | ✅ 支持 | 手动提供 | 已有 Token，Owner 可接收验证码 |
| 格式 3 | ✅ 支持 | ✅ 支持 | 自动登录 | 最简配置，Owner 可接收验证码 |
详细说明：
-
格式 1 (旧格式): 直接使用 ChatGPT Session，Owner 使用 OTP 验证码登录授权。如果 Owner 邮箱是 Gmail 等第三方邮箱，无法接收验证码，则 Owner 账号不会入库，仅邀请成员账号。
-
格式 2 (新格式 + Token): 提供邮箱密码和 Token，Owner 使用密码登录进行授权。适合已经有 Token 且 Owner 邮箱可接收验证码的场景。
-
格式 3 (新格式 无 Token): 仅提供邮箱密码，程序会先自动登录获取 Token 并保存，然后进行后续流程。最简单的配置方式，推荐使用。
4. 运行
# 运行所有 Team
uv run python run.py
# 单个 Team 模式
uv run python run.py single 0
# 测试模式 (仅创建邮箱和邀请)
uv run python run.py test
# 查看状态
uv run python run.py status
🔐 授权服务说明
本项目支持三种授权入库服务，通过 auth_provider 配置选择：
| 服务 | 说明 | 特点 |
|---|---|---|
| CRS | Claude Relay Service | 需手动添加账号，支持 Token 管理 |
| CPA | Codex/Copilot Authorization | 后台自动处理，轮询授权状态 |
| S2A | Sub2API | 支持 OAuth 授权，自动入库，支持分组 |
CRS 配置
auth_provider = "crs"
[crs]
api_base = "https://your-crs-service.com"
admin_token = "your-admin-token"
CPA 配置
auth_provider = "cpa"
[cpa]
api_base = "http://your-cpa-service:8317"
admin_password = "your-admin-password"
poll_interval = 2
poll_max_retries = 30
is_webui = true
S2A 配置
auth_provider = "s2a"
[s2a]
api_base = "https://your-sub2api-service.com/api/v1"
# 认证方式二选一 (优先使用 admin_key)
admin_key = "your-admin-api-key"
admin_token = ""
# 账号配置
concurrency = 10
priority = 50
# 分组配置 (二选一)
group_ids = []
group_names = ["codex"]
📁 项目结构
oai-team-auto-provisioner/
│
├── 🚀 run.py # 主入口脚本
├── ⚙️ config.py # 配置加载模块
│
├── 📧 email_service.py # 邮箱服务 (创建用户、获取验证码)
├── 👥 team_service.py # Team 服务 (邀请管理)
├── 🌐 browser_automation.py # 浏览器自动化 (注册流程)
│
├── 🔐 授权服务模块
│ ├── crs_service.py # CRS 服务
│ ├── cpa_service.py # CPA 服务
│ └── s2a_service.py # S2A (Sub2API) 服务
│
├── 🛠️ utils.py # 工具函数 (CSV、状态追踪)
├── 📊 logger.py # 日志模块
│
├── 📝 config.toml.example # 配置模板
├── 🔑 team.json.example # Team 凭证模板
│
├── 📂 logs/ # 日志目录
│ └── app.log # 运行日志 (自动轮转)
│
└── 📂 自动生成文件
├── accounts.csv # 账号记录
├── team_tracker.json # 状态追踪
└── domain_blacklist.json # 域名黑名单
🔄 工作流程
整体流程图
┌──────────────────────┐
│ 🚀 python run.py │
└──────────┬───────────┘
│
┌──────────▼───────────┐
│ 📋 加载配置文件 │
│ config.toml │
│ team.json │
└──────────┬───────────┘
│
┌──────────▼───────────┐
│ 🔐 验证授权服务连接 │
│ CRS / CPA / S2A │
└──────────┬───────────┘
│
┌─────────────────────────────┼─────────────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 格式 3 │ │ 格式 2 │ │ 格式 1 │
│ 仅邮箱密码 │ │邮箱密码+Token│ │ 完整Session │
└──────┬──────┘ └──────┬──────┘ └──────┬──────┘
│ │ │
▼ │ │
┌─────────────┐ │ │
│ 🔑 浏览器 │ │ │
│ 自动登录 │ │ │
│ 获取Token │ │ │
│ 同时授权 │ │ │
└──────┬──────┘ │ │
│ │ │
└───────────────────────────┼───────────────────────────┘
│
▼
┌───────────────────────────────┐
│ 🔁 遍历每个 Team │
└───────────────┬───────────────┘
│
┌───────────────────────────▼───────────────────────────┐
│ │
│ 📧 Step 1: 批量创建邮箱 │
│ └─ Cloud Mail / GPTMail API │
│ │
│ 👥 Step 2: 批量邀请到 Team │
│ └─ ChatGPT API 邀请成员 │
│ │
│ ┌─────────────────────────────────┐ │
│ │ 🔁 遍历每个邮箱账号 │ │
│ │ │ │
│ │ 🌐 Step 3: 浏览器自动注册 │ │
│ │ └─ DrissionPage 自动化 │ │
│ │ └─ 填写信息 + 邮箱验证码 │ │
│ │ │ │
│ │ 🔐 Step 4: Codex 授权 │ │
│ │ └─ 生成授权链接 │ │
│ │ └─ 自动登录完成授权 │ │
│ │ │ │
│ │ 💾 Step 5: 授权服务入库 │ │
│ │ └─ CRS: 手动添加账号 │ │
│ │ └─ CPA: 后台自动处理 │ │
│ │ └─ S2A: OAuth 自动入库 │ │
│ │ │ │
│ └─────────────────────────────────┘ │
│ │
└───────────────────┬───────────────────┘
│
┌───────────────────▼───────────────────┐
│ 👑 处理 Team Owner (可选) │
│ └─ include_team_owners = true │
└───────────────────┬───────────────────┘
│
┌───────────▼───────────┐
│ ✅ 完成 & 打印摘要 │
│ 📊 保存 CSV 记录 │
└───────────────────────┘
状态流转
账号在处理过程中会经历以下状态：
invited → registered → authorized → completed
│ │ │
│ │ └─→ partial (入库失败)
│ │
│ └─→ auth_failed (授权失败)
│
└─→ register_failed (注册失败)
| 状态 | 说明 | 下一步操作 |
|---|---|---|
invited |
已邀请到 Team | 等待注册 |
registered |
已完成注册 | 等待授权 |
authorized |
已完成授权 | 等待入库 |
completed |
全部完成 | 无 |
partial |
授权成功但入库失败 | 重试入库 |
auth_failed |
授权失败 | 重试授权 |
register_failed |
注册失败 | 重试注册 |
team_owner |
Team Owner (格式1) | OTP 验证码登录授权 |
💡 程序支持断点续传，中断后重新运行会自动从未完成的状态继续处理
三种格式的处理差异
| 阶段 | 格式 1 (完整Session) | 格式 2 (邮箱密码+Token) | 格式 3 (仅邮箱密码) |
|---|---|---|---|
| Token 获取 | 手动提供 accessToken | 手动提供 token | 自动登录获取 |
| Owner 登录方式 | OTP 验证码 | 密码登录 | 密码登录 (登录时同时授权) |
| Owner 授权 | 需自有域名邮箱收验证码 | 密码登录后授权 | 登录时已完成 |
| 成员处理 | 正常流程 | 正常流程 | 正常流程 |
📊 输出文件
| 文件 | 说明 |
|---|---|
accounts.csv |
所有账号记录 (邮箱、密码、Team、状态、授权 ID) |
team_tracker.json |
每个 Team 的账号处理状态追踪 |
domain_blacklist.json |
不可用的邮箱域名黑名单 |
🤝 相关项目
📧 邮箱服务
| 服务 | 说明 | 配置 |
|---|---|---|
| Cloud Mail | 自建邮箱系统 | email_provider = "cloudmail" |
| GPTMail | 临时邮箱服务 (API 文档) | email_provider = "gptmail" |
🔐 授权服务
| 服务 | 说明 | 配置 |
|---|---|---|
| Claude Relay Service | Token 管理服务 | auth_provider = "crs" |
| CLIProxyAPI | Codex 授权服务 | auth_provider = "cpa" |
| Sub2API | OAuth 授权入库 | auth_provider = "s2a" |
⚠️ 免责声明
本项目仅供学习和研究使用。使用者需自行承担使用风险，请遵守相关服务条款。