 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 |
|