后端(rust/src/apix.rs,新模块) - /apix/<slug>?<参数> → 市场 POST /api/v1/ai/request;复用 LLM 的 sk_ 鉴权 + 配额 + 用量统计(slot 带 api/ 前缀,天然归组) - 请求体由网关从 query 拼:asset_id 服务端决定(调用方只能选参数),堵住 「客户端自选最贵资产」的口子;GET 经 proxy_method POST + proxy_set_body 转带体 - data/api-proxies.json(含平台真 Key,等同 users.json 敏感度):base+key+items shm 写穿 ax:,停用=摘键;平台 Key 不回显(只给掩码) - 6 个 nginx 变量 + /_apix_probe/<slug>(internal)免费预估探测,复用 $apix_probe_* 前端(www/apix.html + assets/apix.js) - 市场凭据配置 / 目录直拉(GET /api/v1/assets,跨域已开)/ 代理增删启停 / 复制地址 / 免费预估测试(带回平台余额) 验证 - 回归 261 条全绿(网关 102 + LLM 159,新增 34 条 apix 断言) - 涵盖:无/坏 Key→401、不存在/停用 slug→404、GET 改写 POST、换平台 Key、 体由网关拼、下行 Key 不泄漏、写穿 shm、探测归 api/<slug> 文档 - readme §15.1 API 代理使用 + 变更日志;CLAUDE.md location 表补 ipass_apix
228 lines
8.1 KiB
Rust
228 lines
8.1 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` 的区别:上游表是「一条记录 = 一家厂商(自带基址与
|
||
/// 密钥)」,而 API 代理面对的是**同一个市场**(aimall / 搜蚁智选)——
|
||
/// 所有资产共用一个基址、一把平台 Key,只有 `asset_id` 不同。
|
||
/// 所以凭据放在文件顶层(`base` + `key`),`items` 里只放资产差异。
|
||
///
|
||
/// `key` 是平台真 Key,**敏感级别等同 `users.json`**(data/ 已 gitignore)。
|
||
#[derive(Debug, Clone, Serialize, Deserialize)]
|
||
pub struct ApiProxyStore {
|
||
/// 市场基址,如 `https://souyi.net.cn`
|
||
#[serde(default = "default_apix_base")]
|
||
pub base: String,
|
||
/// 平台 API Key(`ak_...`)。留空 = 未配置,热路径直接 503
|
||
#[serde(default)]
|
||
pub key: String,
|
||
/// slug → 资产映射
|
||
#[serde(default)]
|
||
pub items: BTreeMap<String, ApiProxy>,
|
||
}
|
||
|
||
impl Default for ApiProxyStore {
|
||
fn default() -> Self {
|
||
Self { base: default_apix_base(), key: String::new(), items: BTreeMap::new() }
|
||
}
|
||
}
|
||
|
||
fn default_apix_base() -> String {
|
||
crate::config::APIX_BASE_DEFAULT.to_owned()
|
||
}
|
||
|
||
/// 单个 API 代理条目。
|
||
#[derive(Debug, Clone, Serialize, Deserialize)]
|
||
pub struct ApiProxy {
|
||
/// 市场侧的资产 id(如 `searxng-search`),决定钱花在哪个资产上
|
||
pub asset_id: 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,
|
||
/// 单价(USD),从市场目录同步下来的快照,只用于展示
|
||
#[serde(default)]
|
||
pub price_per_call: f64,
|
||
#[serde(default)]
|
||
pub price_in: f64,
|
||
#[serde(default)]
|
||
pub price_out: f64,
|
||
#[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
|
||
}
|
||
}
|