---

核心特性

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

集成 CLIProxyAPI 管理

• CLI Proxy API Management Center

技术栈

• 后端: 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 服务，即可使用。

Docker 运行

先准备目录：

mkdir -p ~/CPA-Codex-Manager
cd ~/CPA-Codex-Manager
mkdir -p data logs

从 GitHub 直接拉取 compose 示例

curl -O https://raw.githubusercontent.com/Maoleio/CPA-Codex-Manager/main/docker-compose.yml

services:
  cpa-codex-manager:
    image: maoleio/cpa-codex-manager:latest
    container_name: cpa-codex-manager
    restart: unless-stopped
    ports:
      - "8000:8000"
    environment:
      WEBUI_HOST: 0.0.0.0
      WEBUI_PORT: 8000
      WEBUI_ACCESS_PASSWORD: your_secret_password
      APP_DATABASE_URL: data/database.db
      # postgresql
      # APP_DATABASE_URL: postgresql://user:password@host:5432/dbname
    volumes:
      - ./data:/app/data
      - ./logs:/app/logs

字段说明：

• WEBUI_HOST：Web 服务监听地址
• WEBUI_PORT：Web 服务端口，默认 8000
• WEBUI_ACCESS_PASSWORD：Web 管理后台登录密码
• APP_DATABASE_URL：数据库连接地址

启动：

docker compose up -d

查看日志：

docker compose logs -f

更新镜像：

docker compose pull
docker compose up -d

桌面版运行

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

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

页面展示

更新日志

v1.1.0

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

巡检与补货配置建议

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

免责声明

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

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

Star History

---

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