跳到主要内容
SolidwayLLM 网关

以下页面描述网关的预期行为。开源版本与企业版本正在拆分中,首个正式版本发布后细节会同步更新。

核心概念

目标、路由、凭据与会话 —— 后续章节使用的术语,先在这里一次讲清。

有五个术语承载了大部分配置。在这里一次定义清楚,后续章节就不再重复解释。

这五项都在控制台中管理,不在配置文件里。

Provider(服务方)

一个上游 HTTP 服务,使用你选定的某种协议方言。Provider 由名称、base URL 以及它接受的 路由来标识。Provider 在控制台中添加。

Route(路由)

Provider 接受的路径模式,例如 POST /v1/messages。路由决定了 provider 是否可达 —— 没有匹配路由的 provider 永远不会被选中。

路由描述的是请求可以被发往哪里,而不是如何转换。

Credential(凭据)

Solidway 向 provider 认证的方式:一个 Header、一个 Bearer Token,或云厂商的签名方案 (AWS SigV4、GCP ADC)。凭据在控制台录入,加密后落盘。

一个 provider 上的多个凭据构成密钥池。故障转移在池内轮转,负载均衡在池内分配。

Target(目标)

一个具体的 (provider, route, credential) 三元组,是请求可以被发往的实体。 回退链中的每一次尝试,都是针对某个 target 的一次尝试。

Session(会话)

可选的分组,把一连串请求固定在同一个 target 上。当 provider 从本地性中获益时有用。 会话不会覆盖健康状态:被暂停轮转的 target 即使被会话指向,也会被跳过。

它们如何配合

请求 ──► 匹配路由 ──► 选中 provider ──► 选定凭据
                                          │
                                          ▼
                                     target(一次尝试)
                                          │
                                失败? ────┴────► 下一个 target

下一步