Skip to content

端点管理

端点管理是 ccMesh 的核心:在这里维护所有上游 API 提供方,配置协议转换与模型映射,并组成可轮换、可熔断的端点池。

端点管理

端点的增删改查

  • 新增 / 编辑 / 删除 端点。
  • 拖拽排序:调整端点顺序,顺序会影响轮换的起点与优先级。
  • 列表 / 网格视图:按习惯切换展示密度。
  • 启用 / 停用:停用的端点不参与路由。

端点字段

字段说明
名称端点别名,用于识别与日志展示
API URL上游基础地址
API Key上游密钥,界面脱敏显示
认证模式api_key(默认)/ auth_token
经全局代理该端点是否经全局出站代理出网
转换器claude / openai / codex
锁定模型非空则强制覆盖客户端请求的 model(专用型端点);空则透传
模型清单对外暴露 / 已选的模型(聚合型端点,供 /v1/models 公布与展示)
模型映射入站 → 出站模型映射
备注自由说明

三类转换器

ccMesh 支持三种上游协议转换:

  • claude(直通):上游本身是 Anthropic Messages 协议,请求原样转发。
  • openai(转换):在 Anthropic 与 OpenAI Chat Completions 协议之间互转。
  • codex(Responses):面向 Codex / Responses 协议的转换。

选错转换器会导致上游返回协议错误,请按上游实际协议选择。详见 协议转换

模型清单与模型映射

  • 模型清单:决定该端点对外暴露哪些模型,用于 /v1/models 公布与 UI 选择。
  • 模型映射(入站 → 出站):客户端用入站名请求 → 路由匹配后改写为出站名转发上游。

适用场景:

  • 不同上游对同一模型有不同命名,用映射统一对客户端暴露;
  • 把一个对外模型名路由到上游的具体模型;
  • 专用型端点用「锁定模型」强制覆盖客户端 model。

连通性测试

每个端点可执行连通性测试,结果以状态徽章呈现:

  • available(可用)
  • unavailable(不可用)
  • unknown(未知 / 未测试)

测试结果会写入端点的 testStatus,在代理未运行时也作为健康状态的粗略参考。

按模型过滤的轮换与熔断

ccMesh 的轮换与熔断是按模型过滤的:路由某个模型的请求时,只在「支持该模型」的端点之间轮换与熔断,避免不相关端点被误伤或误选。

  • 多端点之间自动轮换分配请求;
  • 某端点连续失败到阈值时切换到下一个;
  • 故障端点进入熔断、被选路跳过,冷却后惰性探测恢复。

详见 轮换与熔断

相关