Skip to content

By-Tian/CPA-Codex-Manager

 
 

Repository files navigation

CPA-Codex-Manager


一款专为 OpenAI 账号池设计的高性能管理面板,集成全自动批量注册、CLIProxyAPI 平台账号池实时监控与智能维护系统。 本项目核心基于 cnlimiter/codex-manager 以及 DestinyCycloid/codex-console 开发。

License: MIT Python


核心特性

  • 多模式并发注册
    • 并行模式:支持最高 50 线程同时发起 1000 条注册任务,极速扩充账号规模。
    • 流水线模式:支持设置随机启动间隔,模拟真实用户行为,规避风控。
  • CLIProxyAPI 账号自动巡检
    • 支持 401 认证失效检测Quota 额度耗尽检测
    • 自动根据配置执行 物理删除 异常账号,保持账号池可用性。
  • 智能自动补货系统
    • 实时号池监控:当 CPA 在线账号低于阈值时,自动触发补货。
    • 自动任务挂载:补货任务自动在首页控制台展示进度,无需人工干预。
    • 详细补货日志:在检测历史中清晰标注触发补货的具体方式、邮箱服务及补货数量。
  • 全栈监控面板
    • 实时日志流:基于 WebSocket 的逐行日志推送,随时监控注册细节。
    • 进度可视化:直接显示成功、失败、剩余数与进度百分比。
  • 多邮箱生态支持:集成 Outlook、TempMail、CloudMail 邮箱服务。
  • 紧急防御与异常熔断
    • 动态阈值保护:巡检时发现就绪账号比例低于设定值(如 50%,可配置)时,自动触发紧急防御,随机清理半量账号。
    • 自定义冷却重试:紧急防御触发后,系统将进入预设的冷却期(如 5 分钟,可配置)后重新开始检测。
    • 异常账号全自动清理:自动移除检测过程中产生 Network Error 或 API 报错的“僵尸”账号。

集成 CLIProxyAPI 管理

技术栈

  • 后端: Python 3.10+, FastAPI, SQLAlchemy
  • 前端: Vanilla JS, WebSocket
  • 数据: SQLite / PostgreSQL
  • 并发: asyncio + ThreadPoolExecutor

快速开始

1. 环境准备

确保已安装 Python 3.10 或更高版本。

# 使用 uv(推荐)
uv sync

# 或使用 pip
pip install -r requirements.txt

2. 配置环境

复制 .env.example.env 后按需修改:

cp .env.example .env

3. 运行项目

python webui.py

访问 http://localhost:8000 即可进入管理面板。

进入系统设置页添加 CPA 服务,即可使用。

4. 桌面版运行

如果你想以桌面窗口方式运行,而不是手动打开浏览器:

pip install pywebview
python desktop.py

桌面模式会:

  • 后台自动启动本地 FastAPI 服务
  • 使用 pywebview 打开内嵌窗口
  • 默认仅监听 127.0.0.1
  • 默认使用本地 SQLite,无需配置 .env

桌面版打包

macOS 桌面版打包

请在 macOS 上执行:

chmod +x scripts/build_macos_dmg.sh
./scripts/build_macos_dmg.sh

打包完成后产物位于:

  • dist/CPA-Codex-Manager.app
  • dist/CPA-Codex-Manager.dmg

Windows 桌面版打包

请在 Windows 系统 上执行:

scripts\build_windows.bat

打包完成后产物通常位于:

  • dist\CPA-Codex-Manager\CPA-Codex-Manager.exe

页面展示

截屏2026-03-25 22 39 46 截屏2026-03-25 22 35 12 截屏2026-03-25 22 39 10 截屏2026-03-25 22 34 33 截屏2026-03-25 22 39 29

更新日志

v1.1.0

  • 注册主流程升级为新的状态机会话链路,整体兼容性与稳定性提升。
  • 批量注册启动流程优化,降低大批量任务在启动阶段的阻塞时间。
  • 批量监控逻辑优化。
  • 注册日志阶段划分重新整理,阶段编号和提示文案更加清晰统一。
  • CPA 上传链路优化,支持更直接的投递流程与更清晰的上传日志。

巡检与补货配置建议

  1. 巡检频率:建议设置为 60 分钟一次,配合账户状态(401/Quota)清理。
  2. 补货方案
    • 建议在 CPA 检测页面开启“自动补货”。
    • 当就绪账号少于指定数量时,触发一次补货。
    • 补货模式推荐使用“并行模式”以提高效率。

免责声明

本项目仅供学习、研究和技术交流使用,请遵守 OpenAI 相关服务条款。

因使用本项目产生的任何风险和后果,由使用者自行承担。

Star History

Star History Chart


CPA-Codex-Manager - 让 CLIProxyAPI 号池管理变得优雅而自动化。

About

CPA-Codex-Manager 是一款专为 OpenAI 账号池设计的高性能管理面板,集成全自动批量注册、CLIProxyAPI 平台账号池实时监控与智能维护功能

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 55.7%
  • JavaScript 25.6%
  • HTML 14.2%
  • CSS 2.9%
  • Shell 0.9%
  • Swift 0.4%
  • Batchfile 0.3%