基于 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 细节与交互体验,减少页面操作时的割裂感。
-
补充细节稳定性处理,尽量减少注册、订阅检测和账号管理过程中出现卡住或误判的情况。
- Web UI 管理注册任务和账号数据
- 支持批量注册、日志实时查看、基础任务管理
- 支持多种邮箱服务接码
- 支持 SQLite 和远程 PostgreSQL
- 支持打包为 Windows/Linux/macOS 可执行文件
- 更适配当前 OpenAI 注册与登录链路
- Python 3.10+
uv(推荐)或pip
为避免解释器混用导致的依赖或导入问题,建议始终使用 python -m ... 形式运行安装和测试命令。
# 1) 创建并激活虚拟环境(示例) python -m venv .venv # Windows .venv\Scripts\activate # macOS / Linux source .venv/bin/activate # 2) 在当前解释器中安装项目和测试依赖 python -m pip install --upgrade pip python -m pip install -e ".[dev]" # 3) 运行测试(始终使用 python -m) python -m pytest -q
不要直接使用裸命令 pytest,否则可能调用到系统里另一个 Python 环境下的 pytest。
如需快速确认当前环境是否正确,可执行:
python -c "import src; print(src.__file__)"
python -m pytest --version根据你的使用环境,我们提供了两种启动方式。如果你想在云服务器上 24 小时挂机注册,强烈推荐使用第二种后台常驻部署。
对于 macOS 或带有较新 Python 环境的 Linux 桌面用户,直接在终端执行以下命令即可拉取并启动:
git clone https://github.com/mwuc/codex-console.git && cd codex-console && pip install -r requirements.txt && python webui.py --port 18080 --access-password admin999
启动成功后,浏览器访问 http://127.0.0.1:18080,密码 admin999 即可使用。
如果你使用的是云服务器(如甲骨文 ARM 实例、Ubuntu 20.04 等),系统默认环境可能较老,且 SSH 断开会导致任务停止。请使用以下步骤进行纯净环境构建与 Systemd 守护进程部署:
一. 安装纯净的 Python 环境 (以 Miniconda 为例)
sudo apt update sudo apt install python3 python3-pip python3-venv # 创建新环境 python3 -m venv codexenv # 激活环境 source codexenv/bin/activate
二. 拉取代码并安装依赖
# 推荐将项目放在 /opt 目录下统一管理 git clone https://github.com/mwuc/codex-console.git /opt/codex-console cd /opt/codex-console pip install -r requirements.txt
三. 注册系统级后台服务 (Systemd)
cat << 'EOF' > /etc/systemd/system/codex.service [Unit] Description=Codex Console Web UI After=network.target [Service] User=root WorkingDirectory=/opt/codex-console # 直接调用 Miniconda 基础环境的 Python,确保依赖互通 ExecStart=/root/codexenv/bin/python webui.py --port 18080 --access-password admin999 Restart=always RestartSec=5 [Install] WantedBy=multi-user.target EOF # 启动并设置开机自启 systemctl daemon-reload systemctl enable codex systemctl start codex
🎉 部署完成! 浏览器访问 http://你的服务器IP:18080,密码 admin999 即可使用。(请确保云厂商防火墙已放行 18080 端口)
本项目仅供学习、研究和技术交流使用,请遵守相关平台和服务条款,不要用于违规、滥用或非法用途。
因使用本项目产生的任何风险和后果,由使用者自行承担。