UniGate dev

通用 AI 网关控制台

UniGate 通用网关

渠道

渠道固定

上游网关的一个模型可能内置多个上游渠道(如 Cline Pass 的 glm 背后随机路由到 alibaba/baseten 等)。这里为每个渠道的每个模型把请求钉到固定内部渠道: 严格固定按固定列表逐个独占尝试(注入 provider.only 或 providerOptions.gateway.only),固定优先注入完整 order 优先序。 「探测」发现该上游内置渠道清单并立即落盘,「验证」逐渠道测试;所有改动立即落盘生效。

路由

—

渠道测试

对所选范围逐个 key 发送真实对话请求:「仅第一个 key」只测第一个启用的 key;「全部 key」对全部启用的 key 逐个完整测试(不因某个 key 通过而跳过其余);「指定 key」只测所选 key。每个 (key, 模型) 独立一行展示结果。

模型状态渠道 / keyHTTP耗时出口返回摘要 / 错误

下游通用密钥

客户端以 Authorization: Bearer <通用密钥> 调用 /v1/chat/completions 与 /v1/models。网关按渠道顺序 + key 顺序做故障转移。可为每个密钥限定可调用的模型(支持通配 claude-* 与正则 re:^gpt-4.*$,留空不限制),不在白名单的请求返回 403。

名称密钥可用模型(逗号分隔,空=不限)状态创建时间

请求日志

—
时间接口状态耗时渠道key模型Tokens (入/出)下游出口错误

错误日志

只收录失败请求(状态 ≥400 或带失败原因),独立保存、不会被成功请求挤出;错误信息含逐 key 失败轨迹,可回答「为什么 502」。

—
时间接口状态耗时渠道key模型Tokens (入/出)下游出口错误

代理池

代理池在本页单独配置连接信息;渠道 key 只选择代理池并设置租约行为。

名称管理端TokenSOCKS5 地址被引用

本地租约

网关当前持有的 IPv6 池租约(申请后缓存在本地,重启后自动复用池端同 ID 租约)。开启「跨渠道复用」的租约会显示其占用的全部分组(BaseURL)——同一分组不会重复出现在同一租约上。

代理池租约 ID占用分组出口 IPv6SOCKS 端口模式请求计数最近换IP

用量统计

设置

路由策略

保存后立即生效(持久化,无需重启)。留空 = 使用环境变量默认值。

熔断(连续失败冷却)

网络/代理错误与上游 5xx 连续失败达阈值后按指数退避冷却该 key(成功即清零并解除冷却);429 另有独立冷却逻辑。冷却中的 key 在「路由」页可见并可手动解除。

模型别名(名称处理)

下游请求名 → 规范模型名,每行一条「别名=规范名」;走路由与上游请求体(先按别名解析再匹配渠道模型列表,并按渠道的名称映射改写上游 model)。别名会出现在 /v1/models。

当前生效:

账号

当前登录用户:—

修改用户名

需验证当前密码;保存后立即生效,当前会话将失效、需用新用户名重新登录。

修改密码

需验证当前密码;新密码 6–128 字符,保存后立即生效。

日志与错误

存储与保留

请求/错误日志自动写入本地 SQLite(data/usage.db,重启不丢;库不可用时退化为内存环形缓冲)。

错误记录(状态≥400)自动携带 请求内容 与 返回内容(截断保存),在「错误日志」页展开详情可见。

编辑渠道

拉取后从候选清单勾选要启用的模型,点「按勾选重建」写入左侧列表;未勾选与上游已不返回的模型都会从列表中移除(需要保留手工补充项时勾选面板里的「保留上游未返回的旧模型」)。重建结果需点「保存」写入配置。

映射的键(下游名)即该渠道「声明支持」的模型:无需再写进上面的模型列表,也会出现在 /v1/models 与路由页。 列表项支持精确名、通配(claude-* / gpt-4?)与正则(re:^gpt-4.*$); 精确名按归一化比较(忽略大小写、供应商前缀与 :free/-free 等后缀), 即上游报 cline-free/deepseek-v4.1-flash:free、下游写 deepseek-v4.1-flash 也能命中并自动按上游写法发送。

候选模型(默认全选 = 以上游为准;点「按勾选重建」后未勾选项与上游已不返回的旧模型都会从列表中移除)
共 0 个

自定义请求头

渠道级代理(可选)

为整个渠道统一设置代理(如代理池):未单独配置代理的 key 全部继承此设置——同一渠道内每个 key 仍是独立租约/出口 IP(同设置不同 IP)。key 块内仍可单独覆盖。

上游 Key(按顺序故障转移)

导入的 key 默认启用、直连,代理可在下方各 key 块中单独设置。
冷却中的 key / (key, 模型) 可在此手动解除(上游已恢复时立即恢复路由,不必等冷却到期):

新建代理池

代理池连接信息只在此配置;配置后到「渠道」中给 key 选择该代理池即可使用。

清除冷却