Files
ipass/rust/src/models.rs
T
admin 1f548ac953 feat(api-proxy): 新增「API 代理」板块,把外部免费 API 市场挂到网关下
后端(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
2026-09-13 02:46:35 +08:00

228 lines
8.1 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! 持久化数据模型。
//!
//! 字段名与旧版 `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
}
}