Commit Graph
8 Commits
Author SHA1 Message Date
adminandClaude Code fefd57ac7f feat(cache): 打通 cargo 客户端路径(裸 token + 401 带 WWW-Authenticate)
cargo 客户端此前有三处独立断裂,任一处都足以让它全程 401、装不上 crate:

1. cargo 发的是**裸 token**(Authorization: sk_…,**无 Bearer 前缀**)
   ⇒ core 的 auth::downstream_key 认不出来。
   core 是 ipass-all / ipass-sso 的 LLM / apix 共用口径,改它爆炸半径太大
   ⇒ 插件内新增 src/key.rs:core 的三种携带方式 + 裸 Authorization
   (已排除 Basic/Token/Digest/Negotiate 前缀)。
   取到的值**仍须过 auth::identity()**(比对 shm 的 ukey: 索引)
   ⇒ 不构成任何授权绕过。
2. 客户端不带凭据去拉索引 ⇒ 网关 401,而 cargo 不会重试。
   修法在网关自发的 config.json 里:加 "auth-required": true,
   cargo 才会给**每个**请求(索引文件 + .crate 下载)附 token
   (cargo 0.100.0 http_remote.rs:522-532 / download.rs:67)。
3. 换源链每跳会重跑 ACCESS 阶段 ⇒ 裸 sk_ 必须与 Bearer 形态同等处理:
   cache.rs 的「客户端 Authorization 是不是本网关的 sk_」改用同一个解析器,
   否则裸 token 会被透传给上游源。

另:401 改为插件自己发(core 的 http::fail 硬编码 &[],加不了响应头),
带 WWW-Authenticate: Bearer realm="ipass-cache";
nginx 侧那三处 add_header 已删除(会叠加成重复头,且对 200 也生效)。

Co-Authored-By: Claude Code <[email protected]>
2026-10-31 12:13:03 +08:00
adminandClaude Sonnet 5.5 c83d4c7515 fix(cache): 换源链重跑 ACCESS 阶段不该重复扣配额
- nginx 的 error_page → 命名 location 会把 phase_handler 重置到 REWRITE
  起点 ⇒ 每一跳都重跑本插件的 access handler ⇒ 一个客户端请求走完 3 跳
  被扣 3 次配额(平时 1 次)⇒ 上游一挂轮转配额只剩 1/3,客户端提前吃 429。
- Memo 加 ChargeGate(Cell<bool> 内部可变性 ⇒ *const Memo 的取法一个字不用改):
  claim() 首次 true、之后 false;claim_quota_charge() 拿不到 memo 时 fail-closed
  照常计费(宁可多扣,不白送配额)。
- access handler 改成只在 claim 成功时才调 auth::check_quota。
- 前提:$cache_ctx 不带 NOCACHEABLE ⇒ 同一请求拿到同一份 memo ⇒ 闸门在换源链上有效。

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
2026-10-31 02:44:54 +08:00
adminandClaude Code ed7fe3cac8 docs(cache): 同步 cool_down_failed 注释到 D3 后的取源个数来源
边界检查的源个数已改为从请求级 memo 取(D3),注释里还留着
"另查上游表取源个数"的旧说法,容易把后来的人带回旧的错配。

Co-Authored-By: Claude Code <[email protected]>
2026-10-31 00:15:59 +08:00
admin 1ab8a84901 fix(cache): 修 read_failed_slot 的未初始化读,补解析失败告警 2026-10-30 23:45:17 +08:00
admin c43ad3749e feat(cache): 失败源进 60s 冷却
换源链在命名 location 里写下 X-Cache-Failed-Slot 响应头,
log 阶段据此把失败的源踢出轮转;最终 502/504 时全部冷却(兜底)。
2026-10-30 20:31:26 +08:00
admin 34eb8c7d0b feat(cache): 三档上游目标变量 + 请求内一致的选源
新增 $cache_target_alt/_alt2、$cache_auth_alt/_alt2 与内部 $cache_pick。
$cache_pick 请求内缓存 ⇒ target/auth/host 必定同源;
$cache_pick 按变量索引读(postconfig 取索引),不用名字查找。
单源配置下行为与旧版逐字节相同。
2026-10-30 20:07:53 +08:00
admin f412ec3dcc feat(cache): 选源纯函数 + 源冷却状态
select() 轮转起点=hash%n,冷却源降权到队尾不丢弃,链长恒为 3;
  冷却项存 shm ch:<route>:<idx>,靠 expires_at 自动过期。
2026-10-30 15:35:49 +08:00
adminandClaude Opus 4.8 2c8fb2a1ee refactor: 改造为独立插件仓 ipass-plugin-cache(对齐兄弟仓形态)
- 扁平化:rust/crates/plugin-cache/src → src/,单包 Cargo.toml(name ipass-plugin-cache 2.0.0),
  path 依赖改 ../ipass-core(内核+vendor ngx),删除旧单体拆分残留(rust/ 层级、
  deps/ipass submodule、.gitmodules、conf/、tests/、多页静态 www/、AGENTS.md)
- R19 启停对齐:access/log 热路径加 plugin_registry::plugin_enabled("cache")
  门控,fail-closed 404(数据面是鉴权后磁盘读,禁用放行=无鉴权读缓存盘);
  location 圈定暂用 8 前缀路由表,ipass_cache 指令待 gateway 接入轮
- 旧独立应用形态保留在 tag legacy-app-final
- 文档:CLAUDE.md(装配关系+未挂载待办+本机编译 env 姿势)、README.md、
  docs/cache-usage.md 保留;docs/plugins.md(单体时代)删除
- 验证:cargo check --release 通过,cargo test 4 passed

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-24 21:15:57 +08:00