CPA-Codex-Manager自动巡检功能详解：401失效与Quota耗尽账号自动清理指南

🔍 CPA-Codex-Manager 是一款专为 OpenAI 账号池设计的高性能管理面板，集成批量注册、CLIProxyAPI 账号池实时监控与智能维护能力。本文聚焦它的自动巡检功能：如何自动检测 401 认证失效账号与 Quota 额度耗尽账号，并一键完成配置，实现账号池的自动化清理与补货。

一、为什么需要自动巡检？

账号池在长期运行中，总会逐渐积累两类"坏账号"：

• 401 失效账号：Token 过期或认证失败，调用接口直接返回401 Unauthorized，账号彻底不可用。
• Quota 耗尽账号：额度用尽，接口返回insufficient_quota/limit_reached等错误，需要等待重置周期才能恢复。

如果号池里混着大量此类账号，CLIProxyAPI 会反复把请求分发给"僵尸"账号，导致整体可用性下降。手动逐个排查几十上百个账号费时费力——这正是CPA-Codex-Manager 自动巡检要解决的问题：

定时对全量账号发起健康探测 → 自动分类异常账号 → 按你的策略自动关闭/删除 → 号池数量不足时自动补货。

二、自动巡检的工作原理

核心逻辑位于 src/web/routes/cliproxy.py 中的AutoPatrolManager类，整体流程如下：

1. 拉取账号列表：通过 CPA（CLIProxyAPI）管理端接口获取全部账号文件；
2. 并发健康探测：以可配置并发（默认 20 线程）调用 src/web/routes/cliproxy.py 中的perform_scan，向每个账号的wham/usage用量接口发起检测请求；
3. 状态判定：
   • 返回401→ 标记为认证失效；
   • 返回200但额度占比used_percent超过阈值（默认 95%）或出现limit_reached→ 标记为额度耗尽；
   • 网络异常 / API 报错 → 标记为异常（僵尸账号）；
4. 执行清理动作：按你的配置对 401 账号执行删除，对额度耗尽账号执行自动关闭或删除，异常账号一律自动删除，详见 src/web/routes/cliproxy.py；
5. 记录巡检历史：每轮结果写入data/cliproxy_patrol.json，每个服务保留最近 50 条，可在页面直接回看。

三、自动巡检配置五步走

第 1 步：获取项目并安装依赖

git clone https://gitcode.com/gh_mirrors/cp/CPA-Codex-Manager cd CPA-Codex-Manager pip install -r requirements.txt

第 2 步：启动管理面板

python webui.py

启动后访问http://localhost:8000进入管理面板（启动入口见 webui.py）。

第 3 步：添加 CPA 服务

进入「系统设置」页，添加你的 CLIProxyAPI 服务（管理端地址 + API Token）。巡检功能以 CPA 服务为监控对象，每个服务可独立配置一套巡检策略。

第 4 步：进入 CPA 检测页配置巡检

打开「CPA 检测」页面（界面见 templates/cliproxy.html，交互逻辑见 static/js/cliproxy.js），切换到「自动」标签页，你会看到这些核心配置项：

第 5 步：保存配置并验证

点击保存后巡检任务会在约 5 分钟后自动启动（多服务还会按首轮错峰机制错开启动，避免同时打满接口）。之后打开页面顶部的巡检历史与日志区，即可看到每轮"有效 / 401 / 额度耗尽 / 异常"的统计与清理数量。

四、两个关键保护机制

🛡️ 紧急防御：防止"误伤"整个号池

当某轮巡检发现就绪账号占比低于触发阈值（默认 < 50%）时，系统大概率遇到的是网络故障或接口整体异常，而不是真的半数账号都失效了。此时 src/web/routes/cliproxy.py 会触发紧急防御：

• 本轮跳过一切清理动作，避免误删可用账号；
• 进入冷却期（默认 5 分钟）后自动重新检测，恢复正常后再继续执行清理。

📦 自动补货：清理后自动把号池"补满"

开启「自动扩容 / 补货」后，当就绪账号数低于触发阈值（默认 10 个）时，巡检结束会自动发起一次批量注册任务（默认补 5 个，支持并行/流水线两种模式），新账号注册完成后直接上传到对应的 CPA 服务。补货进度会在首页控制台展示，无需人工干预。

五、推荐参数与常见问题

📋 参数建议（来自官方 README）

• 巡检频率建议60 分钟一次，配合 401/Quota 清理，兼顾及时性与接口压力；
• 补货建议开启"自动补货"，补货模式用并行模式提高效率。

❓ FAQ

Q1：Quota 阈值在哪里调？手动检测时表单里可设置周额度 / 主额度阈值（默认 95%）。自动巡检沿用配置中的weekly_threshold与primary_threshold，定义见 src/web/routes/cliproxy.py。

Q2：账号被自动删除了能找回吗？"删除"是物理移除账号文件，不可恢复。建议对 Quota 耗尽账号先选自动关闭（仅禁用、不删文件），确认策略稳定后再改为删除。

Q3：巡检历史存在哪里？data/cliproxy_patrol.json，按 CPA 服务分组，每组保留最近 50 条记录，页面「巡检历史」区域可直接查看。

Q4：巡检期间注册任务会互相影响吗？不会。巡检与批量动作任务使用独立的 batch 任务上下文，仅在 CPA 页面内展示，与首页注册监控互不干扰。

结语

对于运维 CLIProxyAPI 账号池的开发者来说，CPA-Codex-Manager 的自动巡检把"发现坏号 → 清理坏号 → 补充新号"这条链路完全自动化：401 失效账号、Quota 耗尽账号、网络异常僵尸账号都会被分类处理，配合紧急防御与自动补货，账号池可以 7×24 小时保持健康状态。配置只需 5 分钟，之后即可安心等待巡检历史里那个不断变大的"已清理"数字 🚀