管理员:渠道与用户
面向管理员的后台配置说明。普通用户无需操作本章。
渠道(Channel)
渠道是"一条通往某上游的连接"。新增渠道需要:
| 字段 | 说明 |
|---|---|
| 类型 | 上游供应商类型(OpenAI / Anthropic / Gemini / Azure / 自定义中转等) |
| Base URL | 上游接口根地址(部分类型可留空用默认) |
| 密钥 | 上游发放的 API Key |
| 模型 | 该渠道支持的模型名单,或映射关系(对外名 → 上游名) |
| 分组 | 该渠道服务于哪些分组 |
| 权重 / 优先级 | 同名多渠道时的分流与优先顺序 |
# 典型:新增一个 OpenAI 渠道
类型: OpenAI
Base URL: https://api.openai.com
密钥: sk-上游key
模型: gpt-4o-mini,gpt-4o
分组: default
注意
渠道密钥为高敏感信息,仅管理员可见,切勿截图外泄。渠道异常会直接影响对应模型可用性。
模型映射
若上游模型名与对外暴露名不同,可在渠道里做映射,例如对外叫 gpt-4o-mini,上游实际是 gpt-4o-mini-2024-xx。这样对外保持稳定命名。
用户与分组
- 用户:可创建/封禁、调整额度、设为管理员。
- 分组:决定可见模型与费率,令牌归属某分组。
- 令牌:管理员可代查、禁用异常令牌。
系统设置
- 站点名称、注册开关、是否允许邮箱注册。
- 全局默认额度、速率限制策略。
- 公告与首页展示内容。
渠道健康与故障切换
网关会探测渠道可用性;某渠道失败时可自动或手动禁用,让流量切到同名其它渠道。建议同名模型至少配两个健康渠道做冗余。
备份
| 对象 | 说明 |
|---|---|
| 数据库 | 用户/令牌/渠道/日志等,定期备份(Postgres 或内置库) |
| 配置 | 渠道与系统设置导出 |
| 密钥 | 上游 Key 妥善保管,勿明文散落 |