Sign inSign up

shadowbaby/claw-proxy-hub

By shadowbaby

•Updated 1 day ago

Claw 类客户端的统一管理反代网关

Image
Languages & frameworks
API management
0

803

shadowbaby/claw-proxy-hub repository overview

⁠ClawProxyHub

Claw 类客户端（LobsterAI / WorkBuddy 等）的统一管理反代网关：核心提供网关、路由、账号、分组、代理、密钥、任务调度与仪表盘，具体客户端实现以插件形式接入，插件源码与发布在独立仓库 ClawProxyHubPlugins⁠。

⁠架构

客户端（Claude Code / Codex CLI / Cherry Studio ...）
   │  /v1/messages · /v1/chat/completions · /v1/responses
   ▼
┌─ ClawProxyHub 核心（单二进制，内嵌仪表盘）───────────┐
│  网关：三协议归一化 → 统一信封（自动协议转换）                 │
│  实例：插件 → 实例（站点地址 + 站点级配置）→ 账号 / 分组       │
│  路由：对外模型别名 → 分组（权重+真实模型映射）→ 账号          │
│  策略：round_robin / random / least_used / sticky         │
│  账号：多步登录 / 刷新 / 401 自动续期与换号 / 账号或分组代理    │
│  任务：interval / daily / once 调度（签到等维护任务）        │
│  存储：SQLite（golang-migrate 启动自动迁移）                │
│  市场：多源索引 → 下载 .cphplugin → 校验 → 安装            │
└────────────┬─────────────────────┘
             │ hashicorp/go-plugin（子进程 gRPC，契约协商 v1/v2）
   ┌─────────┴─────────┐
   ▼                   ▼
 lobsterai 插件     workbuddy 插件   （← ClawProxyHubPlugins 仓库构建发布）
⁠使用流程
  1. 装插件：「插件」→ 插件市场 → 安装（GitHub 不通时可在「插件源」加自建源，或上传离线包）
  2. （多实例插件）建实例：「实例」→ 选插件 → 填站点地址与站点级配置（单例插件首次使用自动落默认实例）
  3. 添加账号：「账号」→ 添加 → 选择插件（多实例插件再选实例）与授权方式
    • lobsterai：浏览器 OAuth / 凭据文件导入
    • workbuddy：手机验证码 / 浏览器授权 / 凭据文件导入
    • newapi：API 密钥 / 密码 / 凭据文件
  4. 建分组：把同实例账号划入分组（分组 = 单实例账号池）
  5. （可选）绑代理：账号或分组绑定出站代理（账号级优先），上游流量经代理
  6. 建路由：对外模型别名（如 deepseek-flash）→ 分组 + 真实模型 + 权重
  7. 建密钥：客户端调用凭据（明文只显示一次），可限定路由范围
  8. 接入客户端：
curl http://127.0.0.1:8080/v1/chat/completions \
  -H "Authorization: Bearer cph-xxxx" \
  -d '{"model":"deepseek-flash","messages":[{"role":"user","content":"你好"}]}'

Claude Code 等客户端把 base URL 指向 http://127.0.0.1:8080，任意协议入口自动转换。

⁠配置（环境变量）

见 .env.example⁠。核心项：CPH_ADDR、CPH_DATA_DIR、CPH_ADMIN_USERNAME/PASSWORD（仅首启引导，之后以数据库为准）、CPH_MARKETPLACE_URL（自建市场索引）。

Tag summary

Content type

Image

Digest

sha256:2c05521cc…

Size

43.9 MB

Last updated

1 day ago

docker pull shadowbaby/claw-proxy-hub