CPA Proxy Pool

CLIProxyAPI 的第三方代理池管理插件。集中管理多个 HTTP/SOCKS5 代理，并批量为认证账号设置或清除 proxy_url。

当前版本：0.3.0

版本要求

Proxy Pool 版本	CLIProxyAPI 版本	可用能力
v0.3.0+	v7.2.123+	完整功能，包括分页筛选、历史代理自动匹配、单账号操作和安全级联停用
v0.2.0	v7.2.123+	基础代理池与批量绑定/清除

推荐使用最新版本 CLIProxyAPI；本版本已在 v7.2.125 验证。低于 v7.2.123 的宿主缺少本插件依赖的插件 ABI / Auth Host API，无法使用。

核心能力

• 代理节点新增、编辑、启用、停用和删除。
• 单账号设置、更换或清除代理，支持跨页批量绑定与批量清除。
• 服务端分页加载认证文件，支持 25/50/100 条分页；可按账号类型、分配状态、代理节点和关键词组合筛选。
• 自动规范化匹配历史手工代理；等价 URL 会关联到已有代理池节点。
• 安全级联停用：扫描全部认证文件并清除关联 proxy_url，失败自动重试；只有全部成功后才停用代理。
• 支持 Codex、Claude、Antigravity、xAI/Grok 认证文件。
• 提供与 CPAMC 一致的管理页面，支持浅色、纯白和深色主题。
• 原子保存代理池状态；同一账号的并发更新自动串行，代理停用期间阻止新的关联分配。

插件负责管理和写入认证文件中的 proxy_url，实际网络代理仍由 CLIProxyAPI 宿主执行。

安装

从 Releases 下载对应平台的压缩包，解压后将动态库放入 CLIProxyAPI 的插件目录：

plugins/linux/amd64/proxy-pool.so
plugins/windows/amd64/proxy-pool.dll
plugins/darwin/arm64/proxy-pool.dylib

在 CLIProxyAPI 的 config.yaml 中启用插件：

plugins:
  enabled: true
  dir: "plugins"
  configs:
    proxy-pool:
      enabled: true
      priority: 1
      # 可选；默认 plugins/proxy-pool/state.json
      # state_file: "plugins/proxy-pool/state.json"

重启 CLIProxyAPI 后，在管理中心打开 代理池 / 账号分流。也可以直接访问：

http://127.0.0.1:8317/v0/resource/plugins/proxy-pool/ui

若页面没有自动获取当前登录状态，请填写 CLIProxyAPI 的 Management Key。手动输入的 Key 只保存在当前浏览器会话中。

Management API

以下路由均受 CLIProxyAPI Management Key 鉴权保护：

方法	路径	说明
GET	/v0/management/proxy-pool/meta	插件信息
GET	/v0/management/proxy-pool/proxies	代理列表
POST	/v0/management/proxy-pool/proxies	新增代理
POST	/v0/management/proxy-pool/proxies/update	更新代理
POST	/v0/management/proxy-pool/proxies/disable	清除全部关联账号后安全停用代理（v0.3.0+）
POST	/v0/management/proxy-pool/proxies/delete	删除代理
GET	/v0/management/proxy-pool/auths	支持的认证账号列表
GET	/v0/management/proxy-pool/auths/page	分页、筛选认证账号（管理页面使用）
POST	/v0/management/proxy-pool/auths/index	分批建立历史代理索引
POST	/v0/management/proxy-pool/assign	批量绑定代理
POST	/v0/management/proxy-pool/clear	批量清除代理

构建

需要 Go 1.26+、CGO 和对应平台的 C 编译器：

go test ./...
CGO_ENABLED=1 go build -buildmode=c-shared -o proxy-pool.so .

Windows 将输出 proxy-pool.dll，macOS 将输出 proxy-pool.dylib。动态库 basename 必须保持为 proxy-pool。

说明

• 代理 URL 支持 http://、https://、socks5:// 和 socks5h://。
• 支持 host:port、host:port:username:password、scheme:host:port 和 scheme:host:port:username:password 紧凑格式；省略协议时默认使用 http，保存时会自动转换成标准 URL。
• 代理密码会写入插件状态文件及对应认证文件，请限制相关目录的访问权限。
• CLIProxyAPI 插件宿主目前没有事务型批量保存接口；批量操作由插件逐文件执行并返回成功/失败明细。
• 停用代理会自动清除全部匹配账号的 proxy_url；直接删除代理池条目不会修改认证文件，页面会在删除前明确提示。
• 本项目是社区维护的第三方插件，并非 CLIProxyAPI 官方组件。

License

MIT