admin
|
2d1bf44eca
|
build: dev profile 关 incremental,让 sccache 生效
dev/test 构建默认 incremental=true,sccache 对增量目标直接拒缓存
(CannotCache(incremental)),target 只增不减。关掉后 dev 构建也能命中外层缓存。
|
2026-11-04 10:42:49 +08:00 |
|
 adminandClaude Code
|
417c8c9be2
|
docs(cache): cargo 客户端配方改成「源替换」
`[registries.crates-io] index = …` 会被 cargo **静默忽略**(继续用真正的
crates.io ⇒ 看着「装成功了」,其实没过网关)⇒ 必须用源替换
([source.crates-io] replace-with + 同名的 [registries.ipass])。
另需 `[registry] global-credential-providers = ["cargo:token"]`,
否则 cargo 对需要鉴权的 registry 直接报
「authenticated registries require a credential-provider to be configured」。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-31 12:13:03 +08:00 |
|
 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
|
85f64f2f1c
|
docs(cache): 说准多源路由凭据门禁的触发条件
门禁拦的是「落库后仍是多源且路由级 key 非空」,不是「本次提交是否形成多源」
⇒ 已经是多源的老路由连改 name/desc 也会 400。注释改成事实。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-31 02:03:09 +08:00 |
|
 adminandClaude Sonnet 5.5
|
dc49c758fc
|
feat(cache): 多源路由不许把路由级凭据发给第三方源(R-T6-12)
- effective_key:有效源数 > 1 时不再回落路由级 key(源没配凭据 ⇒ 空),
单源 / v1 payload 维持原回落语义。
- upsert 写入门禁:落库后有效源数 > 1 且路由级 key 非空 ⇒ Err(⇒ 400),
错误信息说清哪条路由、为什么、怎么改(逐源配 sources[].key)。
- parse_sources 移到 upstreams.rs 并补 7 条单测;字段存在但类型不对 ⇒ Err。
- decode 恢复纯函数:payload 损坏告警挪到读侧,按路由各告警一次,
只报结构(源个数),不落任何内容字节。
- mask_key:长度 < 8 的凭据整体打码,不再暴露明文片段。
- 源池条目数上限 16 条/路由。
- upsert 文档注释对齐 R-T6-14 的 base 语义。
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
|
2026-10-31 01:48:38 +08:00 |
|
 adminandClaude Sonnet 5.5
|
ac1c51d374
|
feat(cache): 管理 API 支持读写源池 sources[]
保存语义:字段不提交 = 不改;提交空数组 = 清空源池(退回单 base)。
视图回显源列表(凭据只给掩码)+ source_count + base_source。
- base 自动补齐 = sources[0].url:让「base 非空」恒等于「已配置」,
sync_shm / reload_shm 的判据一个字不用改(消除 base 空 + sources 非空的 503 错位)。
- 拒绝控制字符(< 0x20 与 DEL):payload 是换行分隔的,值里藏 \n 会把源列表
错位拆行且不报错 ⇒ 静默把请求打到错误的 URL 上。
- 源池变更时清掉该路由的 ch:<route>:<下标> 冷却条目:旧下标会套到别的源头上。
- 源 id 自动生成带 host + 路径,同批次内唯一。
- payload 损坏告警只报结构(行数 / 源个数),不落任何内容字节(payload 含凭据)。
Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
|
2026-10-31 00:59:56 +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 |
|
admin
|
85ec38aa2d
|
feat(cache): shm payload 支持多源(v2),向后兼容 v1 三行格式
v1 payload 仍是三行;v2 在第 4 行打版本标记,源列表每两行一个 (url,key)。
仓内读法 split_payload 取前三行 ⇒ v1/v2 下 base/key/mode 全干净。
旧二进制带的是它自己那份 splitn(3):base/key 仍正确,但 mode 会被后续行污染
(已知残留;生产上无混版本读同一份 shm,唯一暴露面是显式回退二进制)。
|
2026-10-30 15:24:54 +08:00 |
|
admin
|
838f497290
|
feat(cache): 上游模型加多源 sources 字段
旧 JSON 无该字段时走 serde default ⇒ 存量文件不用改、行为不变。
|
2026-10-30 14:46:45 +08:00 |
|
 adminandClaude Code
|
877ab5eaf4
|
docs(cache): 本机构建路径更新为共享位置
影响
- CLAUDE.md 里的 NGINX_SOURCE_DIR 还指向已迁走的旧目录,照着抄会直接构建失败。
改动
- CLAUDE.md:NGINX_SOURCE_DIR 改为 /Users/xs/Documents/ipass/ngxbuild/nginx-1.30.4。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 18:09:15 +08:00 |
|
 adminandClaude Opus 4.8
|
fb704afbda
|
docs: 本机构建源码树引用迁移到共享位置 ipass/ngxbuild
Co-Authored-By: Claude Opus 4.8 <[email protected]>
|
2026-09-26 17:35:37 +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 |
|
admin
|
f7c70a0e19
|
fix(tests): /api/v1/cache* 鉴权改用 X-API-Key (与主仓 Guard::User 一致)
legacy-app-final
|
2026-09-21 13:35:45 +08:00 |
|
ssw
|
0464971c5c
|
仓库拆分:本仓只保留 cache 插件源码,core/gateway/其他插件经 submodule 引入
- 从本仓移除 ipass-core / plugin-domain / plugin-llm / plugin-apix / gateway / vendor/ngx-rust(这些属主项目 ipass/ipass)
- 添加 git submodule deps/ipass -> http://192.168.1.18:13300/ipass/ipass(提供 core/gateway/ngx-rust/其他插件用于编译 cache 插件)
- rust/Cargo.toml workspace 仅含 plugin-cache,依赖经 ../deps/ipass/rust/... 解析
- 移除根 tests/run.sh(主项目通用回归入口,非 cache 专用)
- 修复 .gitignore:所有 tests/cache/.run-* 运行时目录均不入库(此前 .run-auth/.run-cap 被误提交,已解除跟踪)
- 新增/更新 AGENTS.md 与 docs/plugins.md:明确本仓只含 cache 插件、core 从主项目取、submodule 升级方式、构建/接线说明
|
2026-09-21 11:05:45 +08:00 |
|
ssw
|
43718bd0c4
|
iPass cache gateway 源码
容量管理: zones.rs 直读 nginx file_cache 共享内存记账(双轴: 磁盘 + keys_zone 索引内存), ?scan=1 扫盘上限 20 万文件; POST /api/admin/cache/purge 整区清理(只删文件不删目录, 根治 [crit] mkdir failed); POST /api/admin/cache/invalidate 按制品精准失效(预览->确认两步式, glob/子串, 删除上限 5000/扫描上限 20 万); GET /api/admin/cache 新增 capacity 块; 前端容量面板 + 按制品失效工具条; 测试 test-cache-capacity.sh 48/48(容量 27 + 精准失效 21, 含 EXPECT_MIN 护栏与前端静态契约); docs 容量管理章节
|
2026-09-21 09:25:11 +08:00 |
|