1. LLM 上游 / API 代理的「新建 / 编辑」改为弹出卡片(IP.modal), 列表页只留复制地址 / 测试 / 编辑 / 启停 / 删除,体验更轻。 2. API 代理彻底去「API 市场 / 平台级凭据」概念:souyi 仅作供应商之一, 每条代理自带 base / 供应商 Key / asset_id(后端 platform 概念已移除), 源码与文档均不再出现 souyi / AIMALL 品牌与目录直拉。 3. 修 apix.js 示例地址拼接 bug:之前末尾出现 `?q=?q=`, 现 url 只拼一次 `?q=`、示例给出 `?q=关键词`(base 由后端返回纯基址)。 Co-Authored-By: 小K <[email protected]>
220 lines
7.9 KiB
Rust
220 lines
7.9 KiB
Rust
//! 持久化数据模型。
|
||
//!
|
||
//! 字段名与旧版 `data/users.json` / `data/domains.json` **逐字对应**,
|
||
//! 以便新版直接接管旧数据文件、且管理台前端无需改动。
|
||
|
||
use serde::{Deserialize, Serialize};
|
||
use std::collections::BTreeMap;
|
||
|
||
/// 账号表(`users.json`):以账号名为 key 的对象。
|
||
pub type UserTable = BTreeMap<String, User>;
|
||
|
||
/// 单个账号。
|
||
///
|
||
/// `temp_grant_until` 是「临时授权权限」的到期时间戳;> now 表示当前拥有
|
||
/// 该权限,申请临时域名时可跳过审核直接放行。
|
||
#[derive(Debug, Clone, Serialize, Deserialize)]
|
||
pub struct User {
|
||
pub username: String,
|
||
/// 中文姓名等展示名。**只用于展示**,不参与鉴权、不参与热路径查询。
|
||
///
|
||
/// `username` 规则是 ASCII(`valid_username`),中文名塞不进账号名,
|
||
/// 所以「吴桂荣」这类实名单独放这里;留空时前端回落到 `username`。
|
||
#[serde(default)]
|
||
pub display_name: String,
|
||
/// `admin` | `user`
|
||
pub role: String,
|
||
pub salt: String,
|
||
/// 迭代加盐 SHA-256
|
||
pub pwd_hash: String,
|
||
/// `sk_<48 位 hex>`。
|
||
///
|
||
/// LLM 代理与域名接口**共用这一把 Key**——这正是「用同一套 Key 验证」
|
||
/// 的落点,所以重置 Key 会同时影响两个入口。
|
||
pub api_key: String,
|
||
/// LLM 代理可用的上游 slot 白名单。空 = 不限。
|
||
///
|
||
/// 老数据没有该字段,`serde(default)` 反序列化得空表,语义正好是「不限」。
|
||
#[serde(default)]
|
||
pub allowed_models: Vec<String>,
|
||
/// LLM 每分钟请求上限。老数据缺省 → 全局默认(`LLM_RPM_DEFAULT`);0 = 不限
|
||
#[serde(default = "default_llm_rpm")]
|
||
pub llm_rpm: i64,
|
||
/// LLM 每日请求上限。老数据缺省 → 全局默认(`LLM_DAILY_DEFAULT`);0 = 不限
|
||
#[serde(default = "default_llm_daily")]
|
||
pub llm_daily: i64,
|
||
#[serde(default)]
|
||
pub temp_grant_until: i64,
|
||
#[serde(default)]
|
||
pub created_at: i64,
|
||
}
|
||
|
||
impl User {
|
||
/// 是否拥有「临时授权权限」
|
||
pub fn has_temp_permission(&self, now: i64) -> bool {
|
||
self.temp_grant_until > now
|
||
}
|
||
|
||
pub fn is_admin(&self) -> bool {
|
||
self.role == "admin"
|
||
}
|
||
}
|
||
|
||
/// 上游表(`llm-upstreams.json`):以 slot 名为 key。
|
||
///
|
||
/// `slot` 就是 LLM 客户端 URL 的第一段路径:`/openai/v1/chat/completions`
|
||
/// 里的 `openai`。**刻意不按 body 里的 `model` 字段路由**——请求体要到
|
||
/// content 阶段才读得到,而 access 阶段(转发决策点)读不到,
|
||
/// 按 model 分流就得放弃 `proxy_pass` 自己实现 upstream,代价差一个数量级。
|
||
pub type UpstreamTable = BTreeMap<String, Upstream>;
|
||
|
||
/// 单个 LLM 上游。
|
||
#[derive(Debug, Clone, Serialize, Deserialize)]
|
||
pub struct Upstream {
|
||
/// 上游基址,含 scheme,如 `https://api.openai.com`(可带端口)
|
||
pub base: String,
|
||
/// 该上游**挂载的模型名清单**(如 `deepseek-chat` / `deepseek-reasoner`)。
|
||
///
|
||
/// 一个上游(一家厂商)通常挂多个模型,客户端要能先"列出有什么"再选。
|
||
/// 这里只是网关侧的**清单**,用于 `GET /v1/models` 之类的模型发现;
|
||
/// 转发本身仍按 URL 里的 slot 走,**不校验 model 字段**(access 阶段读不到 body)。
|
||
/// 留空表示"清单未知"——模型发现接口就不列该上游的模型,但转发照常可用。
|
||
#[serde(default)]
|
||
pub models: Vec<String>,
|
||
/// 完整的 Authorization 头值,如 `Bearer sk-xxx`。
|
||
/// 留空表示不透传鉴权头(本地免鉴权后端,如 vLLM / Ollama)
|
||
#[serde(default)]
|
||
pub auth: String,
|
||
/// 关闭后该 slot 立即停止转发(保留配置便于恢复)
|
||
#[serde(default = "default_true")]
|
||
pub enabled: bool,
|
||
#[serde(default)]
|
||
pub note: String,
|
||
#[serde(default)]
|
||
pub created_at: i64,
|
||
}
|
||
|
||
fn default_true() -> bool {
|
||
true
|
||
}
|
||
|
||
fn default_llm_rpm() -> i64 {
|
||
crate::config::LLM_RPM_DEFAULT
|
||
}
|
||
|
||
fn default_llm_daily() -> i64 {
|
||
crate::config::LLM_DAILY_DEFAULT
|
||
}
|
||
|
||
/// API 代理表(`api-proxies.json`)。
|
||
///
|
||
/// 与 `llm-upstreams.json` 同构:每条记录 = 一个供应商(自带基址与密钥),
|
||
/// 由 `slug` 区分。调用方访问 `/apix/<slug>?参数=值`,网关用本记录里的密钥
|
||
/// 转发到供应商、并把响应原样返回。不同供应商彼此独立、互不耦合。
|
||
///
|
||
/// `key` 是供应商真 Key,**敏感级别等同 `users.json`**(data/ 已 gitignore)。
|
||
#[derive(Debug, Clone, Serialize, Deserialize)]
|
||
pub struct ApiProxyStore {
|
||
/// slug → 代理映射
|
||
#[serde(default)]
|
||
pub items: BTreeMap<String, ApiProxy>,
|
||
}
|
||
|
||
impl Default for ApiProxyStore {
|
||
fn default() -> Self {
|
||
Self { items: BTreeMap::new() }
|
||
}
|
||
}
|
||
|
||
/// 单个 API 代理条目:指向某一家供应商的一个可调用的资产。
|
||
#[derive(Debug, Clone, Serialize, Deserialize)]
|
||
pub struct ApiProxy {
|
||
/// 供应商侧的资产 id(如 `searxng-search`),决定具体调用哪个资产
|
||
pub asset_id: String,
|
||
/// 供应商名称(仅展示用,管理员自填,例如 `provider-x` / 客户自定)
|
||
#[serde(default)]
|
||
pub supplier: String,
|
||
/// 供应商基址,如 `https://api.example.com`
|
||
#[serde(default)]
|
||
pub base: String,
|
||
/// 供应商 API Key(`ak_...`)。留空 = 未配置,热路径直接 503。
|
||
/// **敏感**:写盘与回显都按密钥处理,管理台只回显掩码。
|
||
#[serde(default)]
|
||
pub key: String,
|
||
/// 展示名(中文)
|
||
#[serde(default)]
|
||
pub name: String,
|
||
/// 一句话说明
|
||
#[serde(default)]
|
||
pub desc: String,
|
||
/// **声明式参数清单**(如 `["q"]`)。
|
||
///
|
||
/// 只用于给调用方看的文档(管理台把 `?q=关键词` 拼出来、账号态接口回显),
|
||
/// 转发时**不按它过滤**——过滤要靠读请求体,而 access 阶段读不到。
|
||
/// 供应商侧自己会拒绝不认识的参数,拦在网关意义不大。
|
||
#[serde(default)]
|
||
pub params: Vec<String>,
|
||
#[serde(default = "default_true")]
|
||
pub enabled: bool,
|
||
#[serde(default)]
|
||
pub note: String,
|
||
#[serde(default)]
|
||
pub created_at: i64,
|
||
}
|
||
|
||
/// 域名表(`domains.json`):一条记录 = 一个子域名。
|
||
#[derive(Debug, Clone, Serialize, Deserialize)]
|
||
pub struct DomainEntry {
|
||
pub id: String,
|
||
pub subdomain: String,
|
||
/// `host:port`
|
||
pub backend: String,
|
||
/// `temp`(临时,到时自动停止转发) | `long`(长期)
|
||
#[serde(rename = "type")]
|
||
pub dtype: String,
|
||
/// 归属账号
|
||
pub owner: String,
|
||
/// `pending` | `approved` | `rejected`
|
||
pub status: String,
|
||
#[serde(default)]
|
||
pub created_at: i64,
|
||
/// 仅 temp 有意义;long 恒为 0
|
||
#[serde(default)]
|
||
pub expires_at: i64,
|
||
/// `auto` 表示凭临时授权权限免审放行
|
||
#[serde(default)]
|
||
pub reviewed_by: String,
|
||
#[serde(default)]
|
||
pub reviewed_at: i64,
|
||
}
|
||
|
||
impl DomainEntry {
|
||
/// 实际状态:approved 的临时域名过期后视为 `expired`。
|
||
///
|
||
/// 这是「到期不等于删除」语义的落点——记录保留,只是不再转发。
|
||
pub fn effective_status(&self, now: i64) -> &'static str {
|
||
if self.status == "approved" && self.dtype == "temp" {
|
||
if self.expires_at > 0 && self.expires_at <= now {
|
||
return "expired";
|
||
}
|
||
}
|
||
match self.status.as_str() {
|
||
"approved" => "approved",
|
||
"rejected" => "rejected",
|
||
_ => "pending",
|
||
}
|
||
}
|
||
|
||
/// 转发侧判定:返回该域名当前是否可转发(已放行且未过期)
|
||
pub fn is_forwardable(&self, now: i64) -> bool {
|
||
if self.status != "approved" {
|
||
return false;
|
||
}
|
||
if self.dtype == "temp" {
|
||
// 临时域名必须有明确的、尚未到达的到期时刻
|
||
return self.expires_at > now;
|
||
}
|
||
true
|
||
}
|
||
}
|