基于 cnlimiter/codex-manager 持续修复和维护的增强版本。
这个版本的目标很直接: 把近期 OpenAI 注册链路里那些“昨天还能跑，今天突然翻车”的坑补上，让注册、登录、拿 token、打包运行都更稳一点。
- GitHub Repo: https://github.com/dou-jiang/codex-console
- 交流群: 291638849（点击加群）
- Telegram 频道: codex_console
首先感谢上游项目作者 cnlimiter 提供的优秀基础工程。
本仓库是在原项目思路和结构之上进行兼容性修复、流程调整和体验优化，适合作为一个“当前可用的修复维护版”继续使用。
-
新增 Sentinel POW 求解逻辑
OpenAI 现在会强制校验 Sentinel POW，原先直接传空值已经不行了，这里补上了实际求解流程。 -
注册和登录拆成两段
现在注册完成后通常不会直接返回可用 token，而是跳转到绑定手机或后续页面。
本分支改成“先注册成功，再单独走一次登录流程拿 token”，避免卡死在旧逻辑里。 -
去掉重复发送验证码
登录流程里服务端本身会自动发送验证码邮件，旧逻辑再手动发一次，容易让新旧验证码打架。
现在改成直接等待系统自动发来的那封验证码邮件。 -
修复重新登录流程的页面判断问题
针对重新登录时页面流转变化，调整了登录入口和密码提交逻辑，减少卡在错误页面的情况。 -
优化终端和 Web UI 提示文案
保留可读性的前提下，把一些提示改得更友好一点，出错时至少不至于像在挨骂。
-
修复注册流程中的问题，解决 Outlook 和临时邮箱收不到邮件导致注册卡住、无法完成注册的问题。
-
修复无法检查订阅状态的问题，提升订阅识别和状态检查的可用性。
-
新增绑卡半自动模式，支持自动随机地址；3DS 无法跳过，需按实际流程完成验证。
-
新增已订阅账号管理功能，支持查看和管理账号额度。
-
新增后台日志功能，并补充数据导出与导入能力，方便排查问题和迁移数据。
-
优化部分 UI 细节与交互体验，减少页面操作时的割裂感。
-
补充细节稳定性处理，尽量减少注册、订阅检测和账号管理过程中出现卡住或误判的情况。
-
新增
CloudMail邮箱服务实现，并完成服务注册、配置接入、邮件轮询、验证码提取和基础收件处理能力。 -
新增上传目标
newApi支持，可根据配置选择不同导入目标类型。 -
新增
Codex账号导出格式，支持后续登录、迁移和导入使用。 -
新增
CPA认证文件proxy_url支持，现可在 CPA 服务配置中保存和使用代理地址。 -
优化 OAuth token 刷新兼容逻辑，完善异常返回与一次性令牌场景处理，降低刷新报错概率。
-
优化批量验证流程，改为受控并发执行，减少长时间阻塞和卡死问题。
-
修复模板渲染兼容问题，提升不同 Starlette 版本下页面渲染稳定性。
-
修复六位数字误判为 OTP 的问题，避免邮箱域名或无关文本中的六位数字被错误识别为验证码。
-
新增 Outlook 账户“注册状态”识别与展示功能，可直接看到“已注册/未注册”，并支持显示关联账号编号（如“已注册 #1”）。
-
修复 Outlook 邮箱匹配大小写问题，避免 Outlook.com 因大小写差异被误判为未注册。
-
修复 Outlook 列表列错位、乱码和占位文案问题，恢复中文显示并优化列表信息布局。
-
优化 WebUI 端口冲突处理，默认端口占用时自动切换可用端口。
-
增加启动时轻量字段迁移逻辑，自动补齐新增字段，提升旧数据升级兼容性。
-
批量注册上限由
100提升至1000（前后端同步）。
- Web UI 管理注册任务和账号数据
- 支持批量注册、日志实时查看、基础任务管理
- 支持多种邮箱服务接码
- 支持 SQLite 和远程 PostgreSQL
- 支持打包为 Windows/Linux/macOS 可执行文件
- 更适配当前 OpenAI 注册与登录链路
- Python 3.10+
uv（推荐）或pip
# 使用 uv（推荐）
uv sync
# 或使用 pip
pip install -r requirements.txt可选。复制 .env.example 为 .env 后按需修改:
cp .env.example .env常用变量如下:
| 变量 | 说明 | 默认值 |
|---|---|---|
APP_HOST |
监听主机 | 0.0.0.0 |
APP_PORT |
监听端口 | 8000 |
APP_ACCESS_PASSWORD |
Web UI 访问密钥 | admin123 |
APP_DATABASE_URL |
数据库连接字符串 | data/database.db |
优先级:
命令行参数 > 环境变量(.env) > 数据库设置 > 默认值
# 默认启动（127.0.0.1:8000）
python webui.py
# 指定地址和端口
python webui.py --host 0.0.0.0 --port 8080
# 调试模式（热重载）
python webui.py --debug
# 设置 Web UI 访问密钥
python webui.py --access-password mypassword
# 组合参数
python webui.py --host 0.0.0.0 --port 8080 --access-password mypassword说明:
--access-password的优先级高于数据库中的密钥设置- 该参数只对本次启动生效
- 打包后的 exe 也支持这个参数
例如:
codex-console.exe --access-password mypassword启动后访问:
docker-compose up -d你可以在 docker-compose.yml 中修改环境变量，比如端口和访问密码。
如果需要看“全自动绑卡”的可视化浏览器，打开：
- noVNC:
http://127.0.0.1:6080
docker run -d \
-p 1455:1455 \
-p 6080:6080 \
-e DISPLAY=:99 \
-e ENABLE_VNC=1 \
-e VNC_PORT=5900 \
-e NOVNC_PORT=6080 \
-e WEBUI_HOST=0.0.0.0 \
-e WEBUI_PORT=1455 \
-e WEBUI_ACCESS_PASSWORD=your_secure_password \
-v $(pwd)/data:/app/data \
--name codex-console \
ghcr.io/<yourname>/codex-console:latest说明:
WEBUI_HOST: 监听主机，默认0.0.0.0WEBUI_PORT: 监听端口，默认1455WEBUI_ACCESS_PASSWORD: Web UI 访问密码DEBUG: 设为1或true可开启调试模式LOG_LEVEL: 日志级别，例如info、debug
注意:
-v $(pwd)/data:/app/data 很重要，这会把数据库和账号数据持久化到宿主机。否则容器一重启，数据也可能跟着表演消失术。
export APP_DATABASE_URL="postgresql://user:password@host:5432/dbname"
python webui.py也支持 DATABASE_URL，但优先级低于 APP_DATABASE_URL。
# Windows
build.bat
# Linux/macOS
bash build.shWindows 打包完成后，默认会在 dist/ 目录生成类似下面的文件:
dist/codex-console-windows-X64.exe
如果打包失败，优先检查:
- Python 是否已加入 PATH
- 依赖是否安装完整
- 杀毒软件是否拦截了 PyInstaller 产物
- 终端里是否有更具体的报错日志
这个仓库更适合作为:
- 原项目的修复增强版
- 当前注册链路的兼容维护版
- 自己二次开发的基础版本
如果你准备公开发布，建议在仓库描述里明确写上:
Forked and fixed from cnlimiter/codex-manager
这样既方便别人理解来源，也对上游作者更尊重。
当前仓库名:
codex-console
本项目仅供学习、研究和技术交流使用，请遵守相关平台和服务条款，不要用于违规、滥用或非法用途。
因使用本项目产生的任何风险和后果，由使用者自行承担。