CPA-Codex-Manager 是一款专为 OpenAI 账号池设计的高性能管理面板，把批量注册、CLIProxyAPI 账号池自动巡检和智能自动补货三大能力整合进一个 Web 控制台，让你不再手写脚本反复刷号、盯号。本文面向新手，带你从安装部署到巡检补货配置，一次性把这个开源工具用明白。

🚀 CPA-Codex-Manager 能帮你做什么？

很多运营 CLIProxyAPI（简称 CPA）号池的朋友都有同样的痛点：注册靠手工、掉线靠肉眼、补号靠熬夜。CPA-Codex-Manager 用一套面板把这些事全部自动化了：

技术上基于 Python 3.10+ / FastAPI / SQLite（也支持 PostgreSQL），前端是轻量原生 JS，详见 README.md 与 requirements.txt。

⚡ 5 分钟快速上手：三种部署方式

方式一：源码启动（最简单）

1️⃣ 克隆仓库：

git clone https://gitcode.com/gh_mirrors/cp/CPA-Codex-Manager

2️⃣ 安装依赖（需要 Python 3.10+）：

# 推荐 uv uv sync # 或 pip pip install -r requirements.txt

3️⃣ 配置环境变量并启动：

cp .env.example .env python webui.py

启动入口是 webui.py，它会自动完成 .env 加载、SQLite 数据库初始化与日志配置，然后访问http://localhost:8000进入登录页。首次登录成功后，进入系统设置页添加你的 CPA 服务地址即可开始使用，Web 应用主体逻辑位于 src/web/app.py。

方式二：Docker 部署（最适合生产环境）

仓库自带 Dockerfile 和 docker-compose.yml，核心只需三个环境变量：

environment: WEBUI_HOST: 0.0.0.0 WEBUI_PORT: 8000 WEBUI_ACCESS_PASSWORD: your_secret_password APP_DATABASE_URL: data/database.db volumes: - ./data:/app/data - ./logs:/app/logs

然后执行docker compose up -d即可；升级镜像用docker compose pull && docker compose up -d，日志用docker compose logs -f查看。

方式三：桌面版（免浏览器，一键窗口）

pip install pywebview python desktop.py

桌面入口 desktop.py 会在后台自动拉起本地 FastAPI 服务并弹出内嵌窗口，默认只监听127.0.0.1、使用本地 SQLite，无需任何.env配置。macOS / Windows 打包脚本在 scripts/build_macos_dmg.sh 与 scripts/build_windows.bat。

🧵 批量注册：两种模式怎么选？

注册任务由 src/web/routes/registration.py 驱动，底层执行引擎是 src/core/register_v2.py。面板提供两种运行模式：

• 并行模式（Parallel）：多线程同时发起，最高 50 线程、1000 条任务，适合需要快速扩充账号规模的场景；
• 流水线模式（Pipeline）：按随机启动间隔逐条发起，模拟真实用户节奏，适合长时间挂机、规避风控的场景。

两个实用细节：

• 注册完成后可勾选auto_upload_cpa，账号会自动投递到指定的 CPA 服务（也支持 Sub2API、TM 平台上传，见 src/core/upload/）；
• 支持代理列表随机轮换与动态代理 API，代理策略在注册流程中自动完成，无需手动干预。

首页控制台（模板见 templates/index.html）会实时显示成功数、失败数、剩余数与进度百分比，日志通过 WebSocket 逐行推送，注册卡在哪一步一目了然。

🔍 自动巡检与智能补货：号池的"自动驾驶"

这是整个面板最有价值的部分，核心逻辑在 src/web/routes/cliproxy.py 的AutoPatrolManager中。

巡检：自动揪出"坏账号"

开启自动巡检后，系统按你设定的间隔（建议 60 分钟一轮）对 CPA 服务里的全部账号做并发探测：

每一轮巡检的扫描结果、清理数量都会写入检测历史，方便回溯。

紧急防御：防止"误伤式清理"

如果某轮巡检发现就绪账号比例低于设定阈值（默认 50%），系统会判定为异常波动：本轮跳过清理，进入冷却期（默认 5 分钟）后重新检测，避免网络抖动导致整池账号被误删。

补货：库存低了自动下单

在 CPA 检测页面开启"自动补货"后，只要巡检发现就绪账号数低于你设定的阈值，系统就会自动挂载一个批量注册任务（推荐并行模式补货更快），注册成功后自动上传回 CPA 服务。补货方式、邮箱服务与数量都会详细记录在检测历史里，全程无需人工干预。

💡 官方推荐配置组合

1. 巡检频率设为60 分钟/次，配合 401/Quota 清理；
2. CPA 检测页开启自动补货，就绪账号低于指定数量即触发；
3. 补货模式选择并行模式提高效率。

📧 邮箱服务：注册的地基

批量注册离不开可靠的邮箱。面板内置三类服务实现（见 src/services/）：

• Outlook 免费邮箱（src/services/freemail.py）
• TempMail 临时邮箱（src/services/tempmail.py）
• CloudMail 云邮箱（src/services/cloud_mail.py）

在/email-services页面添加并启用任一服务后，即可在注册与补货任务中选择它作为收码渠道。统一的服务工厂接口（src/services/base.py）让新增邮箱渠道也非常简单。

🗂️ 核心文件导航

想深入源码时，从这几处入手最高效：

• Web 应用与登录鉴权：src/web/app.py
• 批量注册 API：src/web/routes/registration.py
• 巡检 / 补货调度器：src/web/routes/cliproxy.py
• 注册状态机引擎：src/core/register_v2.py
• Token 刷新与 Sentinel 链路：src/core/openai/
• 全局配置：src/config/settings.py

⚠️ 使用建议与免责声明

• 面板登录密码通过WEBUI_ACCESS_PASSWORD设置，务必使用强密码，公网部署建议配合防火墙限制访问；
• 巡检并发（patrol_workers）与超时（patrol_timeout）可按 CPA 服务负载调整，默认 20 并发 / 45 秒超时；
• 本项目仅供学习、研究和技术交流使用，请遵守 OpenAI 相关服务条款，因使用本项目产生的任何风险和后果由使用者自行承担。

把"刷号、盯号、补号"交给 CPA-Codex-Manager，你只需要在浏览器里看进度、喝咖啡 ☕。