Files
ipass/rust/src/store.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

197 lines
6.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.
//! JSON 文件存储层:原子写 + 跨 worker 互斥。
//!
//! 与旧版 `lua/store.lua` 语义一致——**状态就是几个 JSON 文件**,不引入数据库。
//! 差别只有一处:互斥锁从 `resty.lock`(基于 lua_shared_dict)换成共享内存里的
//! `RwLock`,因为新版已经有一块共享内存了,不必再造一个字典。
//!
//! 所有写操作统一走 `update_*`,流程固定为:
//!
//! ```text
//! 取全局文件写锁 → 读文件 → 闭包修改 → 原子写回 → 放锁
//! ```
//!
//! 闭包返回 `Err` 表示业务校验失败,此时**不落盘**(与旧版 `fn` 返回 nil 一致)。
//!
//! ## 三个表的分工
//!
//! | 文件 | 内容 | 是否进共享内存 |
//! | --- | --- | --- |
//! | `users.json` | 账号、口令哈希、API Key | `ukey:` 索引进(热路径要它) |
//! | `domains.json` | 子域名 → 后端映射 | `sub:` 进(转发热路径) |
//! | `llm-upstreams.json` | LLM 上游基址与密钥 | `up:` 进(LLM 转发热路径) |
//! | `api-proxies.json` | API 市场凭据 + 代理清单 | `ax:` 进(API 代理热路径) |
//!
//! 四个文件都在 `data/` 下,都已 `.gitignore`。**LLM 上游表含上游真 Key,
//! 敏感级别与 `users.json` 相同**,不要再往别处复制。
use std::path::PathBuf;
use std::sync::Mutex;
use crate::config::DEFAULT_DATA_DIR;
use crate::models::{ApiProxyStore, DomainEntry, UpstreamTable, UserTable};
use crate::state;
/// 状态目录。配置阶段由 `ipass_data_dir` 指令设置一次,之后只读。
static DATA_DIR: Mutex<Option<String>> = Mutex::new(None);
pub fn set_data_dir(dir: &str) {
if let Ok(mut slot) = DATA_DIR.lock() {
*slot = Some(dir.to_owned());
}
}
pub fn data_dir() -> String {
DATA_DIR
.lock()
.ok()
.and_then(|s| s.clone())
.unwrap_or_else(|| DEFAULT_DATA_DIR.to_owned())
}
fn path_of(name: &str) -> PathBuf {
PathBuf::from(data_dir()).join(name)
}
pub fn users_path() -> PathBuf {
path_of("users.json")
}
pub fn domains_path() -> PathBuf {
path_of("domains.json")
}
pub fn upstreams_path() -> PathBuf {
path_of("llm-upstreams.json")
}
pub fn api_proxies_path() -> PathBuf {
path_of("api-proxies.json")
}
// ===========================================================================
// 读写
// ===========================================================================
/// 读取并反序列化;文件缺失或损坏时回退 `default`(不抛错,保证转发侧可用)
fn read_json<T: serde::de::DeserializeOwned>(path: &PathBuf, default: T) -> T {
let Ok(text) = std::fs::read_to_string(path) else {
return default;
};
if text.trim().is_empty() {
return default;
}
match serde_json::from_str(&text) {
Ok(v) => v,
Err(e) => {
// 解析失败必须留痕:静默回退会让「数据看起来还在、实际全空」极难排查
crate::util::log_err(&format!(
"[store] 解析失败,回退默认值:{} ({e})",
path.display()
));
default
}
}
}
/// 原子写:先写 `<path>.tmp` 再 rename,避免读到写了一半的内容
fn write_json<T: serde::Serialize>(path: &PathBuf, value: &T) -> Result<(), String> {
let text = serde_json::to_string(value).map_err(|e| format!("序列化失败:{e}"))?;
let tmp = PathBuf::from(format!("{}.tmp", path.display()));
std::fs::write(&tmp, text.as_bytes()).map_err(|e| {
let _ = std::fs::remove_file(&tmp);
format!("写入临时文件失败:{e}")
})?;
std::fs::rename(&tmp, path).map_err(|e| {
let _ = std::fs::remove_file(&tmp);
format!("重命名失败:{e}")
})
}
// ===========================================================================
// 对外接口
// ===========================================================================
pub fn read_users() -> UserTable {
read_json(&users_path(), UserTable::new())
}
pub fn read_domains() -> Vec<DomainEntry> {
read_json(&domains_path(), Vec::new())
}
pub fn read_upstreams() -> UpstreamTable {
read_json(&upstreams_path(), UpstreamTable::new())
}
pub fn read_api_proxies() -> ApiProxyStore {
read_json(&api_proxies_path(), ApiProxyStore::default())
}
pub fn write_users(data: &UserTable) -> Result<(), String> {
write_json(&users_path(), data)
}
pub fn write_domains(data: &[DomainEntry]) -> Result<(), String> {
write_json(&domains_path(), &data.to_vec())
}
pub fn write_upstreams(data: &UpstreamTable) -> Result<(), String> {
write_json(&upstreams_path(), data)
}
pub fn write_api_proxies(data: &ApiProxyStore) -> Result<(), String> {
write_json(&api_proxies_path(), data)
}
/// 加锁「读-改-写」账号表。
///
/// 闭包返回 `Ok(T)` 表示提交,`Err(msg)` 表示放弃(不写盘)。
pub fn update_users<T, F>(f: F) -> Result<T, String>
where
F: FnOnce(&mut UserTable) -> Result<T, String>,
{
let _guard = state::file_lock().ok_or("内部错误:状态锁不可用")?;
let mut data = read_users();
let out = f(&mut data)?;
write_users(&data)?;
Ok(out)
}
/// 加锁「读-改-写」域名表
pub fn update_domains<T, F>(f: F) -> Result<T, String>
where
F: FnOnce(&mut Vec<DomainEntry>) -> Result<T, String>,
{
let _guard = state::file_lock().ok_or("内部错误:状态锁不可用")?;
let mut data = read_domains();
let out = f(&mut data)?;
write_domains(&data)?;
Ok(out)
}
/// 加锁「读-改-写」LLM 上游表
pub fn update_upstreams<T, F>(f: F) -> Result<T, String>
where
F: FnOnce(&mut UpstreamTable) -> Result<T, String>,
{
let _guard = state::file_lock().ok_or("内部错误:状态锁不可用")?;
let mut data = read_upstreams();
let out = f(&mut data)?;
write_upstreams(&data)?;
Ok(out)
}
/// 加锁「读-改-写」API 代理表
pub fn update_api_proxies<T, F>(f: F) -> Result<T, String>
where
F: FnOnce(&mut ApiProxyStore) -> Result<T, String>,
{
let _guard = state::file_lock().ok_or("内部错误:状态锁不可用")?;
let mut data = read_api_proxies();
let out = f(&mut data)?;
write_api_proxies(&data)?;
Ok(out)
}