chatgpt_register_web 使用说明

这个项目是一个基于 Python 的 ChatGPT 批量注册工具，提供两种使用方式：

• Web 界面：推荐，配置和操作都在浏览器里完成
• 命令行：直接运行脚本，按提示输入参数

1. 你需要先准备什么

最低要求：

• Python 3.11 或更高
• 建议安装 uv，项目里已经有 pyproject.toml 和 uv.lock
• 可访问 OpenAI 的网络环境，通常需要代理
• 一个可用的 DuckMail API Token

如果你没有 uv，也可以用 pip 安装依赖。

2. 先配置 config.json

根目录已经有一个 config.json，至少要确认下面这些字段：

必填

• duckmail_bearer
  • DuckMail 的 Bearer Token
  • 这是项目真正必填的配置，不填基本跑不起来

强烈建议填写

• proxy
  • 代理地址，项目默认示例是 127.0.0.1:10808
  • 如果你的环境必须翻墙访问 OpenAI，这项通常也算必填

常用配置

• workers
  • Web 页面默认并发参考值
• duckmail_api_base
  • 默认是 https://api.duckmail.sbs
• enable_oauth
  • 是否启用 OAuth 获取 token
• oauth_required
  • 是否要求 OAuth 成功，否则注册算失败
• oauth_issuer
  • 默认 https://auth.openai.com
• oauth_client_id
  • 默认已写好，一般不用改
• oauth_redirect_uri
  • 默认 http://localhost:1455/auth/callback

输出文件相关

• output_file
  • 注册结果输出文件，默认 registered_accounts.txt
• ak_file
  • 默认 ak.txt
• rk_file
  • 默认 rk.txt
• token_json_dir
  • 默认 codex_tokens

账号池相关，可不配

如果你只想本地注册，不需要配 pool。

• pool.base_url
• pool.token
• pool.target_type
• pool.target_count
• pool.interval_min

pool 这一组是给账号池同步、清理、补量、守护任务用的，不影响基础注册。

3. 推荐启动方式：Web 界面

在项目根目录执行：

uv sync
uv run uvicorn web_app:app --host 0.0.0.0 --port 8080 --reload

或者直接：

python web_app.py

启动后打开：

http://127.0.0.1:8080

Web 界面里可以做这些事：

• 保存配置
• 启动/停止批量注册
• 查看实时日志
• 查看注册结果
• 下载 ak.txt / rk.txt
• 管理账号池
• 拉取和测试代理

4. 命令行用法

如果你不想开 Web：

uv run python chatgpt_register.py

或者：

python chatgpt_register.py

运行后会交互式询问：

• 是否使用默认代理
• 注册数量
• 并发数

5. 如果你不用 uv

可以直接装依赖：

pip install requests fastapi "uvicorn[standard]" curl-cffi python-multipart
python web_app.py

6. 环境变量也可以覆盖配置

代码里支持环境变量覆盖 config.json，常用的有：

• DUCKMAIL_BEARER
• DUCKMAIL_API_BASE
• PROXY
• ENABLE_OAUTH
• OAUTH_REQUIRED
• OAUTH_ISSUER
• OAUTH_CLIENT_ID
• OAUTH_REDIRECT_URI
• AK_FILE
• RK_FILE
• TOKEN_JSON_DIR

也就是说，如果你不想把敏感信息写死到 config.json，可以改走环境变量。

7. 运行后会产出什么

默认会在根目录或指定目录生成这些内容：

• registered_accounts.txt
  • 每行一个注册结果
• ak.txt
• rk.txt
• codex_tokens\
  • 保存 OAuth / token 相关 JSON

8. 最短可执行步骤

如果你只想先跑起来，按这个顺序做：

1. 安装 Python 3.11+
2. 安装 uv
3. 编辑根目录 config.json
4. 至少填好 duckmail_bearer
5. 如果需要代理，再填 proxy
6. 执行 uv sync
7. 执行 uv run uvicorn web_app:app --host 0.0.0.0 --port 8080 --reload
8. 浏览器打开 http://127.0.0.1:8080

9. 你实际最需要配置哪些东西

如果目标只是“能用”：

• 必配：duckmail_bearer
• 大概率必配：proxy
• 一般不用动：OAuth 默认配置
• 不做账号池管理时：pool 整段都可以先不填

10. 常见问题

启动失败

先确认：

• Python 版本是否至少 3.11
• 依赖是否安装完成
• 当前目录是否就是项目根目录

注册失败很多

优先检查：

• duckmail_bearer 是否有效
• 代理是否可用
• 本机网络是否能访问 OpenAI
• DuckMail API 是否可访问

打开页面但功能报错

多数情况是：

• config.json 缺关键字段
• 代理不可用
• 账号池地址或 token 配错