//! 持久化数据模型。 //! //! 字段名与旧版 `data/users.json` / `data/domains.json` **逐字对应**, //! 以便新版直接接管旧数据文件、且管理台前端无需改动。 use serde::{Deserialize, Serialize}; use std::collections::BTreeMap; /// 账号表(`users.json`):以账号名为 key 的对象。 pub type UserTable = BTreeMap; /// 单个账号。 /// /// `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, /// 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; /// 单个 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, /// 完整的 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/?参数=值`,网关用本记录里的密钥 /// 转发到供应商、并把响应原样返回。不同供应商彼此独立、互不耦合。 /// /// `key` 是供应商真 Key,**敏感级别等同 `users.json`**(data/ 已 gitignore)。 #[derive(Debug, Clone, Serialize, Deserialize)] pub struct ApiProxyStore { /// slug → 代理映射 #[serde(default)] pub items: BTreeMap, } 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, #[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 } }