admin
|
2cd2ba43b9
|
docs(readme): 补 1.0.16/1.0.17 变更记录 + 1.0.19 发版与复验结论
- 1.0.16(me 承载能力目录)/ 1.0.17(备份路径 + 审计目录 777 + 去本地 rollback 标签)
两条此前漏登记(commit dfbfe5c / 6b8d694)
- 1.0.19 记为已发版,附 commit/digest/job 与线上复验结论
- 记两个发版副发现:宿主控制面 ipass-agent.py 仍是旧版;
容器 TZ=UTC 导致时间显示与趋势日界偏移(与 RESET_DAY_OFFSET_SEC 耦合,改一处必改另一处)
|
2026-09-14 20:16:30 +08:00 |
|
admin
|
1bc316e014
|
fix(stats): 「上次落盘」记录移入共享内存(1.0.19)
1.0.18 首次线上验证暴露:error.log 里有 10 次 [stats] 落盘(来自 6#0/18#0/23#0
多个 worker),GET /api/admin/stats/persist 却报「本进程还没落过」。
根因:LAST_DUMP_AT 是每 worker 的进程内静态量。maybe_dump() 挂在记账路径上,
而记账每 worker 各算各的 → 落盘时刻也就每 worker 一份;接口落到没落过盘的
worker 就报 0。与 1.0.18 已修过的 spr:last(上次恢复)是同一类错误。
修法:发布到共享内存 spd:last(publish_dump 取 max)。一次解决两件事:
* 上报一致 —— 所有 worker 报同一份;
* 节流收敛 —— maybe_dump 新增慢路径查它,把「8 个 worker 各写一遍同一个文件」
收敛成「全局每间隔一次」。快路径仍是原子比较,热路径代价不变。
顺带:
- 新增回归断言「状态页报告的上次落盘时刻非空」(套件开 2 worker,能暴露该分歧)
- deploy/agent.sh 加 stats-persist / stats-dump 子命令(线上观测口)
- 统一文档里过期的断言条数(90/111/160/179/196/262/298 → 实际值)
- 记录审计容量巡检 LAST_PURGE_AT/PURGING 同为每 worker 静态量(另案)
回归:bash tests/run.sh all → 299 条全绿(网关 102 + LLM 197)。
|
2026-09-14 20:05:51 +08:00 |
|
admin
|
16cf68d132
|
feat(stats): 运行期统计落盘/恢复 + 审计口径收口 (1.0.18)
起因:发版后管理台「用量」与「趋势」从 0 重新长起来。根因是统计类键
(ust:/ums:/utt:/utms:/ud:/udu:/uds:/uda:/uex:/uh:)只活在共享内存,
进程退出即消失;而上游/账号/域名/用户都有 data/*.json 所以不丢。
统计落盘(新 stats_persist.rs):
- 快照 data/llm-stats.json(与 users.json 同级),原子写 <path>.tmp.<pid> + rename
- 两个落盘点互补:worker 退出钩子 exit_process(发版/docker stop,零丢失)
+ 记账后按间隔节流落盘(默认 60s,覆盖 SIGKILL/OOM/断电)
- 启动 init_process 恢复,put-if-absent → 多 worker 幂等、不覆盖新数据
- 白名单 10 个统计前缀;刻意排除配置类/ukb:/内核态(各有数据文件或重启清零更安全)
- 恢复结果发布 shm spr:last(不再放进程内静态量,否则接口落到哪个 worker 报哪个数)
- 接口 GET /api/admin/stats/persist + POST /api/admin/stats/dump
- 指令 ipass_stats_persist <秒>(0=只留退出钩子);生产 conf 刻意不写
fix(audit): excerpt 双重编码
- json_quote_bytes(手工转义+两侧引号)塞进 json!() 被二次转义,落盘成
"excerpt":"\"{\\\"model\\\"…",解码后多一层引号,消费方全解析不到
- 改为 excerpt_text():只 from_utf8_lossy,转义交给 serde
docs: 新增 docs/llm/STATS_PERSISTENCE.md(含 runbook)、docs/llm/AUDIT_LOG.md
(两者此前被代码注释与 Dockerfile 引用但文件并不存在)
tests:
- 新增【15】统计落盘/重启恢复 13 条(间隔压 1s → 快照产出与白名单 →
nginx -s quit → 恢复键数 == 快照键数、用量不变、再打一笔 +1、趋势仍在)
- 【13】「不再生成 body 副本」改断言本轮增量 = 0(对历史残留免疫);
选择器改 body_bytes>400 且取最后一条匹配(目录里有首版的双重编码行)
- run.sh 复位改用 mv(rename 不算删除)——本机 safe-delete 钩子在累计删除
超 50 个文件后会静默拦掉后续删除,rm -rf 与 python rmtree 同样被拦
- 回归 298 全绿(网关 102 + LLM 196)
|
2026-09-14 19:32:17 +08:00 |
|
admin
|
6b8d694c54
|
deploy(agent): 备份改 ~/ipass/backup/ + 删 rollback-* 标签 (1.0.17)
3 处变更,都是苏苏 9-14 反馈:
1. **备份路径**:从 `~/ipass-data-backup-<时间>.tar.gz` 改成
`~/ipass/backup/ipass-data-<时间>.tar.gz`。
`ls ~` 不再被一堆 `ipass-data-backup-*.tar.gz` 文件刷屏。
2. **审计目录权限**:宿主侧首建 audit/ 目录后显式 `chmod 777`。
agent 是 root 跑的,`os.makedirs` 创建的目录属主是 root,
但容器内 worker 是 nobody,写不动 → 日志刷
`[audit] 建日期目录失败 Permission denied`、整个审计废掉。
用 777 而非按 uid chown:宿主 uid 与容器内 nobody uid 不一定一致
(镜像内 nobody=65534,宿主 root mkdir 后 uid=0),按 uid 改
要么拖数字要么拖 docker 进程解析;777 简单可读,
且 audit 是「append-only JSON 元数据」、没有防篡改语义。
3. **去掉「旧镜像留 rollback tag」步骤**:镜像动辄 100 MB+,
本地磁盘会越积越多;阿里云私仓永远保留所有 tag,需要时
`docker pull` 即可。
- 删除 §3(7 步变 6 步:2/6 备份 → 3/6 删容器 → 4/6 起新容器 →
5/6 自检 → 6/6 探活)
- 删 `ROLLBACK_PREFIX` 常量
- `op_rollback` 不再自动选 local rollback-tag,**必须显式传 tag**,
否则报错指引去阿里云拉
- 同时清掉 .11 上积的 `ipass-gateway:rollback-20260912-104954` (144 MB)
CLAUDE.md 同步:发版/回滚段补三条 1.0.17 注意事项。
|
2026-09-14 18:01:27 +08:00 |
|
admin
|
dfbfe5cf6c
|
docs(me+plugin): 登记 /api/v1/me 能力目录扩展点(1.0.16)
CLAUDE.md
- 「核心机制」补第 6 条:/api/v1/me 是插件装饰扩展点,不是写死端点;
加新字段往 decorate_me 里塞,不要另开 v1 端点(避免老客户端脚本被破坏,
也避免能力目录被拆成 N 个调用)
- 提示协作者给同事/文档/SDK 展示能力时直接讲 me
docs/plugin/PLUGIN_ARCHITECTURE.md
- §2.3 更新 decorate_me 签名为 (User, port)(1.0.16 引入):传 &User 让
装饰零额外 shm 查询就能做权限收敛(upstreams 按 allowed_models 过滤);
port 从 Host 头取(不写死是已知坑)
- 新增「decorate_me = 能力目录的承载点」子段:拍板决策 + 当前塞入字段表
(domains / llm_usage / policy / upstreams / apix)+ 新增字段的纪律
- §6 纪律补第 7 条:能力目录走 decorate_me,不要另开 /api/v1/catalog
- §7 已拍板补 1.0.16 一条 "me 承载能力目录"
不动代码,仅文档同步。
|
2026-09-14 17:25:10 +08:00 |
|
admin
|
479024c61e
|
feat(api): /api/v1/me 聚合能力目录 (upstreams + apix) (1.0.16)
- plugin-apix: 新增 apix::enabled(),仅列 enabled=true 的代理
- ipass-core: CoreExt::decorate_me 签名加 &User 和 &port,让装饰零额外
shm 查询就能做权限收敛(upstreams 按 allowed_models 过滤)
- gateway::GatewayExt: decorate_me 多塞 upstreams(白名单过滤)和 apix
(仅 enabled)两个字段;port 从请求 Host 头取(适配 88 / 443 反代)
老 3 个端点 /api/v1/{upstreams,apix,domains} 保留不破坏。同事拿 key 一个
me 拿全能力目录,不再需要分别调三个端点。
回归 281 全绿(网关 102 + LLM 179)
|
2026-09-14 17:14:00 +08:00 |
|
admin
|
f34ba3d198
|
fix(llm): auth 规范化兜住「只填裸 key」+ 排障子命令 (1.0.15)
线上 minimax 2 把 Key 点「测试」红字:1004 Please carry the API secret key
—— 根因是表单 placeholder 写 sk-...,用户照着填了**裸 key**(无 Bearer ),
而 accounts[].auth 语义是「完整 Authorization 头值」,转发时原样发就 1004。
agent.sh upstreams 一打就看出对照组:deepseek=Bearer s...d425(正常),
minimax=sk-cp-...(**无 Bearer **)——光看截图红字只会猜「额度用完」。
plugin-llm
- upstreams::normalize_auth:trim 后含空白→已完整;否则补「Bearer 」。
**双处应用**:upsert 写入(下次保存自愈) + read_upa 读出(让线上坏数据
立即可用,无需用户重填——存量 10 把 Key 根本不可能通知用户重填)。
- 兼容 Basic / 自定义 scheme / 前后空格 / 内部含空格共 6 个边界,
干跑 + e2e 2 条新断言全过(裸 key 200 + 靶机实收 Bearer sk-NORM-NO-SCHEME)。
前端
- placeholder 改为「Bearer sk-…(... 留空=保留原值;只填裸 key 也会自动补 Bearer)」
——placeholder 写「前缀」会诱导漏填必要部分,写「字面值」才能正确引导。
- 多账号小节加说明文字(只填裸 key 也会自动补 Bearer)。
deploy/agent.sh
- 新增 upstreams(逐账号掩码/冷却/今日负载;掩码为空显式标 **空** —— 这条
是发现「只填裸 key」类问题的关键指示器,旧镜像的回显脱敏后看不出问题)
- 新增 upstream-test <slot>(调测试接口并打印厂商真实 status_code + body),
避免再靠「管理台截图 OCR」排障。
回归 281 全绿(网关 102 + LLM 179);专章 docs/llm/MULTI_ACCOUNT_ROUTING.md §10
记录现象/规则/兼容表/自检工具。
|
2026-09-14 14:21:48 +08:00 |
|
admin
|
ab44853413
|
deploy(agent): verify 增加 .env 默认 tag 漂移告警
update 不带 tag 时用 .env 的 IPASS_IMAGE_TAG 做缺省值,它落后于线上会
**静默降级**回旧镜像(真踩过:1.0.14 发完,.env 仍停在 1.0.9)。
verify 是发版一条龙的最后一步,在那里固定自检一次最省事:
- 一致 → 「✓ 默认 tag 与线上一致」
- 落后 → 「! ... 会退回 xxx」提示(不判失败)
- 未设 → 「! 未设 IPASS_IMAGE_TAG」
已用 5 组输入干跑验证分流(含 registry 前缀 / 裸 tag / 前缀相同易误判)。
另记:.env 受沙箱写保护,只能人工改,所以文档明确要求把同步交回用户。
文档:readme §12.6 + CLAUDE.md 硬约定。
|
2026-09-14 12:16:01 +08:00 |
|
admin
|
f4adb5685c
|
deploy(agent): verify 增加「账号级负载字段」换新证据
1.0.14 起单 auth 的旧记录也会合成 accounts[],投影带 load;
旧镜像 items 里没有 accounts 键 —— 可干净区分新旧镜像。
三态判定(ok / noupstream / old)避免线上无上游时假失败。
已用 6 组输入干跑验证(含 data 为数组的兼容分支)。
|
2026-09-14 12:05:37 +08:00 |
|
admin
|
51c473bdd7
|
docs(llm): 补上游负载列示意图 + 沉淀 ipass-admin-ui-verify 技能
- docs/llm/MULTI_ACCOUNT_ROUTING.md §7.2 加界面示意图(含双 Key / 单 Key / 无账号三形态)
- 新增项目级技能 .workbuddy/skills/ipass-admin-ui-verify:管理台前端改动
的无头渲染验证流程(桩全局 + 真实资源、playwright executablePath 版本坑、
base href 陷阱、程序化断言清单、必须同步的后端/回归断言点)
|
2026-09-14 11:59:37 +08:00 |
|
admin
|
bfa3cf8ff8
|
feat(llm): 上游多账号路由 + 账号级负载统计 (1.0.14)
一个 slot 挂多把上游账号 Key,解决厂商「单账号额度/并发受限」与
「同一用户缓存命中」两个矛盾诉求。
多账号路由 (plugin-llm)
- models: Upstream.accounts[] (auth/note/resets) + 上游级
exhaust_status/exhaust_markers;顶层 auth 保留兼容(accounts 为空时合成单账号)
- upstreams::pick_account:粘性绑定 ukb:<key> 优先 → 无绑定时
FNV-1a(下游 Key) % 可用数 冷分散 → 绑定账号冷却则重新分散 → 全冷却取最早恢复
* 分散避开厂商单账号 agent 并发上限;落点固定保住 prompt/token 缓存
- cool_until_until 天锚定冷却:boundary = day0 + ceil(已过/窗口)*窗口,
封顶次日 0 点(MiniMax 5h 窗口、24=5*4+4 → 末段 20:00-24:00 只有 4h 随天重置)
- 耗尽双检测 (log 阶段):$upstream_status 命中 exhaust_status,或
usage_filter 流式扫到 marker → $llm_acct 定位本次账号 → 写冷却 uac:
- shm: up:/upa:/uac:/ukb:/upe: 五类前缀;$llm_acct 变量 (NOCACHEABLE)
账号级负载统计(问题发现与跟踪)
- 新增 uda:<slot>:<idx>:<day>(请求/token)与 uex:(耗尽次数) 日桶,
复用内核 usage::bump_day —— 无数据库、无新进程(项目红线)
- 计数点只在 log 阶段一次;pick_account 会被 $llm_target/$llm_auth/$llm_acct
三个变量各触发一次,放进那里会三倍计数
- view() 投影带每账号 load 与 account_trend + trend_labels(日期由后端算)
- 管理台「上游」页密钥列:各 Key 今日请求/token/耗尽 + 负载比例条 +
14 天迷你趋势(自绘 SVG,零第三方依赖)+ 冷却/耗尽徽标 + 上游合计
测试与验证
- 回归 279 条全绿(网关 102 + LLM 177),新增 6 条多账号/负载断言
- 假上游新增 UPSTREAM_FAIL_AUTH 模拟账号额度耗尽;靶机验证 Key 真被替换
- 前端以真实 admin.css + upstreams.js 渲染路径做无头浏览器断言:
比例条与负载成比例(412 vs 96 → 100%/23%)、每账号 14 条块、
悬停峰值日期与数据逐位吻合、单账号/无账号兜底正常、无横向溢出、零 JS 错误
文档
- 新增 docs/llm/MULTI_ACCOUNT_ROUTING.md(数据模型/路由/冷却数学/shm 布局/负载统计)
- readme §11 数据模型 + §15 上游配置 + §15 用量统计 + §12.6 tag 表 + §16 变更记录
- 修正 docs/llm/*.md 中插件化前的过时路径(rust/src/* → crates/plugin-llm/src/*)
|
2026-09-14 11:57:08 +08:00 |
|
admin
|
db99ce1521
|
docs: 文档与注释系统性对齐插件化现状 + 清理前身实现引用
- readme §16 补 1.0.10-1.0.13 四条变更记录;§12.6 tag 表补 1.0.9-1.0.13
- readme §5 架构图更新为插件化结构(PLUGINS 注册表/四开关/四表)
- readme §11 补 api-proxies.json 数据模型小节;§8 管理台表格补 API 代理行
- readme/CLAUDE.md 测试断言数对齐 262(102+160);三个 JSON 改四个
- CLAUDE.md LLM 落点表改 crates/plugin-llm 路径;发版补 git push 前置教训
- 清理全部前身实现引用(readme 三处、CLAUDE.md 性能章节、util.rs 注释)
- PLUGIN_ARCHITECTURE.md 增补 1.0.13 sso 合流记录
|
2026-09-13 18:27:28 +08:00 |
|
admin
|
ee05b27a36
|
refactor(core): 采纳 sso 上游化 4 条 —— A1/A2/A3 + A1 配套
按 sso/docs/upstream-core-changes.md 评估后的采纳清单:
A1(强采纳):User 增加 `extra` flatten 透传通道,让插件字段不再污染内核模型
A1 配套:新增 `users::update_extra<T,F>`,与 set_allowed_models 同源
A2(修真 bug):state::split_value `position` → `rposition`(payload 含 0x1f
时被 position 截断;sso 已踩、rposition 取最后一个边界)
A3:state::iter_prefix_ex 返回 (key, payload, exp);iter_prefix 保留兼容包装
不采纳:A4(iPass 已具备大部分,plugin-sso 自实现)、A5(选选项 2 零代码)、
A6-1(破坏测试边界用例,iPass 内核最小约束,由插件加策略)、
A6-2(admin login 端点直接用 COOKIE_NAME)
262 项回归全绿(gateway 102 + llm 160)。
详见 docs/plugin/SSO_UPSTREAM_DECISIONS.md。
|
2026-09-13 17:43:13 +08:00 |
|
admin
|
ddd4172517
|
docs(plugin): P5 收尾 —— 方案转正 PLUGIN_ARCHITECTURE.md + 文档对齐 workspace
- docs/plugin/PLUGINIZATION_PLAN.md 转正为 PLUGIN_ARCHITECTURE.md(as-built):
记录三处方案修正(sso 不迁入已拍板、CoreExt 注册表、trend 留 gateway、
apix 记账走 plugin_llm::stats 单一写入口)
- CLAUDE.md:目录地图改 workspace 结构 + 三条插件化新纪律 + 单 crate 迭代命令
- readme.md:§6 目录结构对齐(crate 划分 / apix 页 / 262 项回归)
- 新增用户级技能 ipass-core-add-plugin(5 处装配缺一不可 + 症状→根因表)
|
2026-09-13 12:22:15 +08:00 |
|
admin
|
85ea0a1531
|
refactor(plugin): P4 拆 plugin-apix —— API 代理迁入独立插件,过渡期路由清空
- plugin-apix 新 crate:apix/handlers/api/config/models/store
- ApiProxy/ApiProxyStore、api-proxies.json 读写、ax: 键空间与 APIX_* 常量自内核迁入
- ApiProxyHandler 与 $apix_* 六变量注册归 ApixPlugin;用量记账仍走 plugin_llm::stats(同一片键空间、单一写入口)
- gateway 路由表只剩 trend 组合端点(需 users+upstreams+apix 三方名册)
- 行为等价:262 项回归全绿(gateway 102 + llm 160)
|
2026-09-13 12:16:47 +08:00 |
|
admin
|
0d8e1c94d1
|
refactor(plugin): P3 拆 plugin-llm —— LLM 路由/配额/计量/审计/趋势迁入独立插件
- plugin-llm 新 crate:llm/upstreams/usage_filter/llm_audit/stats/handlers/api/config/models/store
- 下行契约(downstream_key/identity/check_quota/fail)与记账原语(usage::bump/read/bump_day)已下沉 ipass-core
- usage_filter 改走 loc::enabled(Switch::Llm) + core::plugin::ctx_index(解除对 gateway 私有 ModuleConfig 的依赖)
- gateway 收缩为壳:LlmHandler/LlmHealthHandler/AuditHandler 随 LlmPlugin 装配;
/api/admin/trend 留 gateway(需 users+upstreams+apix 三方名册,组合根职责)
- 行为等价:262 项回归全绿(gateway 102 + llm 160)
|
2026-09-13 12:08:34 +08:00 |
|
admin
|
74aeefee58
|
refactor(plugin): P0-P2 插件化落地 —— workspace 化 + ipass-core + plugin-domain
- P0: rust/ 改 workspace(ipass-core 内核 + gateway 唯一 cdylib),
[profile.release] 上移根、依赖收敛 workspace.dependencies;
users::delete 的 stats::forget 依赖改为 on_delete 钩子注册表
- P1: 契约层 core/plugin.rs(Plugin trait)+ core/loc.rs(Switch 并集 +
set_switch_fn,未实现变体保守 false);gateway PLUGINS 分发循环,
不认领统一 404(插件绝不自行 404)
- P2: 身份端点下沉 core/api.rs(CorePlugin + CoreExt 扩展注册表,
gateway 作装配根回填域名数/用量/连带回收/白名单校验);
plugin-domain crate(domains + DomainEntry + sub: 前缀 + ResolveHandler
+ $proxy_backend_addr + 域名类端点含 purge)
- 行为等价:conf/nginx.conf、Dockerfile、tests 零改动,262 回归全绿
- 方案文档 docs/plugin/PLUGINIZATION_PLAN.md
|
2026-09-13 11:43:22 +08:00 |
|
 adminand小K
|
1fb83e4dda
|
feat(admin/apix): 编辑改弹出卡片 + API 代理去「市场」概念 + 修示例地址拼接
1. LLM 上游 / API 代理的「新建 / 编辑」改为弹出卡片(IP.modal),
列表页只留复制地址 / 测试 / 编辑 / 启停 / 删除,体验更轻。
2. API 代理彻底去「API 市场 / 平台级凭据」概念:souyi 仅作供应商之一,
每条代理自带 base / 供应商 Key / asset_id(后端 platform 概念已移除),
源码与文档均不再出现 souyi / AIMALL 品牌与目录直拉。
3. 修 apix.js 示例地址拼接 bug:之前末尾出现 `?q=?q=`,
现 url 只拼一次 `?q=`、示例给出 `?q=关键词`(base 由后端返回纯基址)。
Co-Authored-By: 小K <[email protected]>
|
2026-09-13 10:19:33 +08:00 |
|
admin
|
dbee9ff3fd
|
fix(admin): 登录页因会话探测 401 被通用兜底重定向,导致自刷新死循环
登录页通过 GET /api/admin/session 探「是否已登录」,未登录时后端返回 401。
core.js 的 api() 通用兜底『401 且路径不含 /login → 跳 login.html』会把这个
本属正常的 401 也当作会话过期重定向回 login.html,形成自刷新死循环,
使未登录用户永远卡在刷新、无法进入。
修复:将 /api/admin/session 排除出通用 401 兜底(其 401 = 未登录,本就该留页)。
已逐条验证:未登录留页 / 已登录跳 overview / 后台页过期跳登录 / 其它接口 401 兜底不变。
|
2026-09-13 09:30:03 +08:00 |
|
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 |
|
admin
|
c426789734
|
feat(admin): 用量图表(趋势/token/按人/按 API 组)+ 管理台单页拆分多页
后端
- 新增日桶 ud:/udu:/uds:(键名带日窗 id,TTL 90 天),record 记请求、
add_tokens 记 token,两者写同一批键、字段互补;forget 同步清 udu:
- 新增 GET /api/admin/trend?days=N(默认 14、上限 90),返回图表可直接吃的
{labels,total,users,slots},每条含 requests/in/out 三条等长数组
- util::fmt_day 供 x 轴用(%m-%d)
前端(原 www/admin.html 1100+ 行单文件)
- 拆为 login.html + overview/review/domains/users/upstreams/usage.html
- 抽出 assets/:admin.css + core.js(请求/登录守卫/外壳)+ chart.js(自绘 SVG)
- 每页 <base href="/admin/">;nginx 侧 /admin 仍进总览,/admin/ alias 到 www/
- 图表零第三方依赖(CDN 会让内网部署白屏,本地副本要塞几百 KB 进镜像)
验收
- 回归 227 条全绿(网关 102 + LLM 125)
- agent.sh verify 新增「趋势接口返回 7 天序列」作为镜像换新证据
|
2026-09-13 00:42:13 +08:00 |
|
admin
|
adbd2dee61
|
docs(readme): §12.5 控制面自更新脚本 / §12.6 tag 表补 ipass-1.0.7 / §16 续5 变更日志
|
2026-09-12 18:02:34 +08:00 |
|
admin
|
401f9be351
|
feat(llm): token 计量 + 对话审计日志(10GiB 容量触发式清理)
- llm_usage.rs: body filter 旁路(FFI 注册 top_body_filter,无需额外 C 模块),
透传 SSE 的同时抓尾部 usage chunk(OpenAI stream_options.include_usage / Anthropic message_delta),
解析 prompt/completion tokens 写 shm utt:/utms: 键
- llm_audit.rs: log 阶段把请求体临时文件复制进审计目录(audit/ = data 兄弟目录),
meta.jsonl 记 user/slot/status/token;10 GiB 容量阈值触发式清理,按日期目录从最旧删起
- conf/nginx.conf: LLM location 去掉 proxy_request_buffering off(它管请求体方向、
与 SSE 无关且与 client_body_in_file_only 互斥),SSE 流式由 proxy_buffering off 保障
- stats/api: 用量接口增加 tokens 维度(today/total per user per slot)
- ipass-agent.py: 容器重建时自动挂审计卷(宿主 audit/ = data 兄弟目录,自动建目录)
- update-agent-face.sh: 控制面自更新脚本(.11 上一行命令完成下载/备份/校验/重启/自检)
- tests: LLM 117/117(+6: 审计 4 + token 2)、网关 90/90,共 207 全绿
|
2026-09-12 17:59:34 +08:00 |
|
admin
|
658356b20a
|
feat(deploy): 控制面收敛到 deploy/agent.sh,凭据不再出现在命令行
安全策略里有一条:**可疑的 bash 命令即使已加进 permissions.allow 白名单,
仍需人工批准**(内置文档 cli/security.md「命令注入检测」)。含
`Authorization: Bearer …` / `. ./.env` / 从环境取口令的命令正好命中,表现是
每次弹「凭证授权」;被拒时命令静默无输出,看着像服务故障——本轮实测一次
`/update` 就是这样根本没发出去(/jobs 里没有新任务、镜像还是旧的)。
所以把控制面全部封进 deploy/agent.sh:凭据只从仓库根 .env 读,对外暴露的
全是无凭据子命令,只需放行 `Bash(bash deploy/agent.sh:*)`。
- status / containers / logs / data / jobs / job / raw:只读查询
- update [tag] / wait <job> / rollback [tag] / restart / pull:变更与轮询
- release <tag>:构建推送 → 更新 → 验收,一条龙
- verify:**正式环境验收** —— 登录线上管理台 → 核对页面新标记
(布局 max-width:1100px、subdomain_rule、cdSubRoll)→ 读
GET /api/admin/domains 确认后端 subdomain_rule 已生效。
只看容器起来是不够的,这条才证得了「镜像真换新 + 新代码在跑」。
修一个中文项目高频坑:变量后紧跟中文标点会被并进变量名
(`$LIVE_PORT(` → 变量名 `LIVE_PORT(`)→ unbound variable;已改 ${LIVE_PORT}
并用脚本全量扫过一遍(0 处残留)。
CLAUDE.md 补「含凭据的命令不要手敲」硬约定 + 沙箱启用前必须先解决的两条
(docker 与沙箱不兼容需 excludedCommands;测试 nginx 绑 0.0.0.0 与沙箱冲突)。
readme §12.5 补 agent.sh 用法,§12.6 登记 ipass-1.0.6,§16 补本条目。
|
2026-09-12 16:27:30 +08:00 |
|
admin
|
12f20dd342
|
fix(admin): 管理台布局改为自适应(去掉 1180px 居中和宽度锁)
大屏上 .wrap 的 max-width:1180px 让面板只占中间一小块,右侧留大片空白、
表格被压窄。改为铺满视口,面板/表格跟着自适应。
配套给 .grid-form 限宽 1100px:面板铺满后 auto-fit 的 minmax(160px,1fr)
会把字段摊成十几列;限住表单容器宽度即可让列数自然收敛,表格不受影响。
1920 视口实测:面板 1872px / 表格 1830px(改造前 ~1132px),表单 1100px。
|
2026-09-12 16:11:28 +08:00 |
|
admin
|
e14d2c6512
|
feat(domains): 子域名规则固化为 i + 8 位随机数 + dm
管理台「新建域名(直接放行)」的子域名不再是自由输入,改为三段拼装:
固定 i + 8 位随机数字(带「换一个」)+ 固定 dm。
- **规则真源收敛到 config.rs**(ENTERPRISE_ZONE / SUBDOMAIN_PREFIX /
SUBDOMAIN_SUFFIX / SUBDOMAIN_RAND_DIGITS / SUBDOMAIN_GEN_ATTEMPTS),
经 GET /api/admin/domains 的 subdomain_rule 下发给面板,前端不硬编码。
- **dm 后缀是硬约束**:conf/nginx.conf 企业域名 server 的 `^(?<subdomain>.+dm)`
要求捕获组以 dm 结尾,否则域名建出来也匹配不上转发 server。已在
config.rs / CLAUDE.md / readme §4 三处互标(改一处必改另一处)。
- **API 同规则**:POST /api/admin/domains/create 的 subdomain 缺省/空串即
自动生成同形态子域名,撞车自动换号重试(最多 5 次);手填撞车直接报错。
管理台与 API 共用 domains::create_by_admin,规则不会两处漂移。
- **域名列表点完整域名即复制**,且带端口——端口跟随调用方(location.port),
用 :88 打开面板就复制成 …:88;view() 增 host 字段供面板渲染。
- util::rand_digits 用**拒绝采样**(只收 <250 的字节)保证 0-9 等概率;
随机源不可用时退化 xorshift,绝不 panic(panic=abort 会打死 worker)。
回归:网关 +13 条(→90),全量 **201 条**(网关 90 + LLM 111)失败 0;
新增段覆盖规则下发 / 形态 ^i[0-9]{8}dm$ / 空串同自动 / 两次随机不同 /
手填合规 / 重复手填 400。另用真实 Chromium 实测布局、换号、非数字过滤、复制。
顺带纠正文档里偏 1 的旧条数(78→90 / 77→111),readme §16 补本条目。
|
2026-09-12 15:43:12 +08:00 |
|
admin
|
82ca6a6302
|
docs(claude): 新增「凭据与授权」章节
- 约定凭据唯一入口为仓库根 .env(已 gitignore),开工先 source,不再向用户索要令牌/口令/域名
- 禁止把 .env 内容打印到输出;上游厂商真 Key 不复制到本地
- 记录命令免授权白名单位置 .workbuddy/settings.local.json(本机、不入库)
|
2026-09-12 15:11:17 +08:00 |
|
admin
|
f9cc76d4b4
|
docs: readme 登记 ipass-1.0.5(健康标记/测试按钮/复制地址)与客户端防错指引
|
2026-09-12 14:53:36 +08:00 |
|
admin
|
1b0bde9f72
|
feat(llm): 上游健康自动标记 + 管理台连通性测试 + 可复制 API 地址
- 健康标记(log 阶段):真实转发的上游状态码写入 uh:<slot>(4xx=活着,
5xx/502/504=失效,下次成功自动自愈),数据来源就是真实流量本身,
无需常驻探测进程。状态码读 $upstream_status 变量(r->upstream 在
上游 finalize 时已置空,log 阶段读不到——access log 同款手法)。
- 管理台「测试」按钮:POST /api/admin/upstreams/test?slot=X,校验后
ngx_http_internal_redirect 到管理 server 内部 location /_upstream_test,
复用 LLM 链路的取 slot / 拼路径 / 换真 Key 逻辑,上游原话透传给面板。
⚠️ 内部重定向只浅拷贝 ngx_str_t,URI 必须拷进请求池——否则函数返回
即悬垂,log 阶段 r->uri 全是 NUL,健康标记静默失效(实测踩坑)。
- 上游列表每行 slot 旁 OpenAI / Anthropic 两枚点击复制地址按钮,
模型发现(/v1/models 与 /api/v1/models、/api/v1/upstreams)附
anthropic_base_url 与健康状态;anthropic_base_url 统一收口
upstreams::anthropic_base_url(),base 已钉 /anthropic 时不重复追加。
- 统计卡片挪进独立「数据总览」tab 并设为默认页。
- 回归 +12 条(第 12 节健康标记断言),LLM 111 + 网关 78,失败 0。
- 测试卫生:run.sh 启动靶机前 pkill 残留进程(占 18999 会造成假 200)。
|
2026-09-12 14:42:32 +08:00 |
|
admin
|
b76213bebb
|
docs(llm): 补落地记录(出站头策略 + 统一注册),并同步 readme
- docs §七:本次改造实际发出的配置、生产验收表(.11 临时挂 echo 上游)、
反证结果(还原成改造前 → 3 条凭据断言如实变红)、统一注册的改前改后实测、
两个副作用(路径空间放大 / base_url 变协议中立)与回退命令。
- readme:§12.6 tag 表补齐 1.0.2 / 1.0.3 / 1.0.4(这三版此前没登记);
§15 增加提示框说明「base 写到哪一层决定 base_url 是否协议中立」及
Anthropic 客户端必须自己补 /anthropic;§16 补本轮变更记录。
|
2026-09-12 12:46:42 +08:00 |
|
admin
|
9ebee9c96d
|
fix(llm): 出站请求头默认不放行(allowlist),堵住网关 Key 经 x-api-key 泄漏
行业做法(LiteLLM / one-api / Higress 完全一致):**不由客户端决定**上游该收到哪些头,
而是网关按「上游需要什么」重新构造。nginx 侧对应 proxy_pass_request_headers off。
改造前实测(本机靶机 + .11 生产双确认):本块只覆写了 Authorization,客户端放在
x-api-key 里的**网关自己的 Key** 会被原样送给上游厂商,厂商可拿它反调本网关挂的
**全部**上游(横向越权)。MiniMax 两处都认,把这个缺陷掩盖成了 200。
改动:
- conf/nginx.conf 与两个测试模板:off + 凭据头显式抹空(x-api-key / api-key /
x-goog-api-key,两层叠加,将来谁改回 on 仍兜底)+ 显式放行
Content-Type / Accept / anthropic-version / anthropic-beta / openai-beta / User-Agent
- tests/llm/e2e.sh:+12 条断言。凭据头不泄漏、必需头存活(漏 Content-Type 会让所有
POST 直接废)、以及 host 粒度 base 下一条记录吃 OpenAI + Anthropic 两种路径
- 反证:把模板还原成改造前状态(无 off、无抹空)重跑,3 条凭据断言如实变红(86/3),
证明这组断言不是空转
回归:LLM 89 + 网关 78,失败 0。调研与实测证据见 docs/llm/UPSTREAM_PROTOCOL_AND_AUTH.md
|
2026-09-12 12:39:03 +08:00 |
|
admin
|
9ede90b06e
|
docs(llm): 多协议路由与鉴权头调研(开源实现 + 官方指引 + 实测)
- LiteLLM:/anthropic/* 路径前缀路由;clean_headers 的 authenticated_with_header
语义 + 默认摘凭据头 + 双层 allowlist + 日志/转发两副本分离
- one-api:根地址 + 路径天然区分,model 只选 channel,出站三头齐设
- Higress:Automatic Protocol Detection;v2.2.3 把按模型名宽泛匹配改成路径后缀判断
- Anthropic 官方:走网关用 ANTHROPIC_AUTH_TOKEN(发 Authorization),直连才用
ANTHROPIC_API_KEY(发 X-Api-Key)
- 靶机改为记录全部收到的头:手挑字段会让未替换的头在回归里全绿通过
结论:协议由客户端路径表达,不需要网关分发;统一注册的实体是 base 写到 host。
鉴权头两种修法与 off 模式的必注入清单(漏 Content-Type 会让所有 POST 废)见文档。
|
2026-09-12 12:27:41 +08:00 |
|
admin
|
02601f6d33
|
test(llm): 靶机补记 x-api-key / anthropic-version
Anthropic 协议的鉴权头是 x-api-key,而网关当前只覆写 Authorization。
靶机原来不记录 x-api-key,导致「下游那把 sk_ 是否被原样漏给上游」
在回归里是看不见的 —— 实测已确认会漏。先让靶机把它记下来。
|
2026-09-12 12:15:35 +08:00 |
|
admin
|
2ad9ac7815
|
fix(admin): 上游表单的地址/密钥输入框独占整行,不再被网格压到 ~170px
问题:`.grid-form` 用 `repeat(auto-fit,minmax(160px,1fr))`,在 1180px 容器里
排成 6 列、每格仅 172px。上游地址(如 https://api.minimaxi.com/anthropic
约需 266px)与密钥(60+ 字符约需 670px)必然显示不全。
改动(www/admin.html):
- 新增 `.span-all{grid-column:1/-1}`,上游表单用 `.up-form` 收成两列:
slot / 备注 各一列(539px),地址 / 密钥 / 模型各独占整行(1090px)
- 窄屏(≤600px)收成一列
- 地址 / 密钥输入框加 `.field-mono`(等宽字体,便于逐字符核对路径与密钥)
- 地址标签补「含路径段,如 /v1」,placeholder 换成真实在用的带路径地址
- 上游列表的地址列加 `word-break:break-all`,长地址折行而非撑破表格
实测(Playwright 无头 Chromium,1440 / 1180 / 420 三种视口):
- 地址框 1090px(可用文本 1068px)vs 需要 266px → 余量充足
- 密钥框 1090px vs 需要 673px → 完整可见(约可容纳 127 字符)
- 窄屏 420px 收成一列(330px),地址完整显示
- 上游列表表格宽 1090px < 面板 1132px,未撑破;地址单元格折行
回归:bash tests/run.sh all → 网关 78 / LLM 77 = 155 条,失败 0。
|
2026-09-12 12:06:09 +08:00 |
|
admin
|
d870168ca3
|
docs(CLAUDE): 硬规矩补「写共享内存失败必须出声」
|
2026-09-12 11:48:57 +08:00 |
|
admin
|
12f3fc4ac5
|
fix(state): 共享内存写失败必须出声,避免「新建 Key / 域名 / 上游」静默不生效
背景:热路径(LLM 鉴权查 ukey:、转发查 sub:、上游查 up:)**只读共享内存、无回源兜底**,
所以写穿失败 = 功能立刻不可用。而三处 sync_shm 都把 state::put_* 的 bool 返回值丢掉了:
- users::sync_shm → put_ukey 失败 = 该 Key 调 LLM 直接 401
- domains::sync_shm → put_backend 失败 = 该域名直接 404
- upstreams::sync_shm → put_upstream 失败 = 该上游直接 404
表现为「新建/改完就是不生效,日志里什么都没有」——最难查的一类形态。
改动(仅加日志,不改控制流):
- 三处 sync_shm 在 state::put_* 返回 false 时 log_err,带上对象标识与后果
- 三处 reload_shm 增加「期望条数 vs 实际装载」核对,不全时汇总报 error
(domains 只把 forwardable 计入期望,不可转发的条目不装载不算失败)
- users::reload_shm 顺带把 read_users() 取一次复用,避免读两遍
回归:bash tests/run.sh all → 网关 78 / LLM 77 = 155 条,失败 0。
|
2026-09-12 11:48:32 +08:00 |
|
admin
|
13c0c7a427
|
fix(deploy): ipass-agent 加「受管容器」锁,破坏性操作只碰 ipass 容器
问题:update / restart / rollback 的 name 参数**没有任何校验** —— 传
{"name":"invoicehelper-nginx"} 就会去重启/删除同机别的容器(.11 上还跑着
invoicehelper-nginx、d15-nginx-1 等)。
修复:
- 新增 managed_container() / ensure_managed():--name 指定者优先 → 自动探测到的
ipass 容器 → 两者都没有时退化为 ipass* 前缀白名单
- _post 同步前置校验(非法 name 直接 403、**不建任务**);op_update 内再校验一次
(op_rollback 内部也走 op_update,纵深防御)
- _dispatch 把 PermissionError 映射为 403;/containers 保留全量但标注 managed;
/ 与 /logs 统一走受管容器
- VERSION 1.0.0 → 1.0.1
本地实测(自造 victim-app + ipass-dt2 两个容器,未触碰任何真实业务容器):
- `--name ipass-dt2`:对 victim-app 发 restart/update/rollback 全部 403,且
victim-app 的 State.StartedAt 前后完全一致;对 ipass-dt2 正常重启
- 无 `--name` 且机器上没有 ipass 容器:victim-app → 403(前缀白名单);
ipass-x 通过校验后由 docker 报「No such container」
|
2026-09-12 11:02:28 +08:00 |
|
admin
|
327838b427
|
fix(deploy): release.sh 变量后紧跟中文标点补花括号($VAR( → ${VAR}()
|
2026-09-12 10:56:03 +08:00 |
|
admin
|
0266a48103
|
feat(deploy): release.sh 发版脚本,固化「镜像 tag 只增不改」
- 对外 tag 用 ipass-1.0.N:每有一次改动 +1 推新 tag,绝不覆盖已推送的 tag
(覆盖会让远端 pull 内容与本地缓存 / rollback-* 标签错位 → 回滚选错镜像)
- release.sh:校验 git 工作区干净 → docker manifest inspect 拦同名 tag →
DOCKER_BUILDKIT=0 经典构建 → 推送 → 打印 .11 控制面更新命令
- readme §12.6 新增「镜像发版与 tag 约定」+ tag 对照表;§12.5 示例改用最新 tag
- CLAUDE.md 硬约定新增「发版」条 + 「发版(本机)」小节
已推送 ipass-1.0.1(digest 226321bec…,= base_url 端口跟随 Host 的修复版)
|
2026-09-12 10:55:28 +08:00 |
|
admin
|
2f21f4b1c5
|
fix(deploy): ipass-agent 回滚点判重改按镜像 id;回滚改按 tag 时间戳选最近
两个缺陷都只在「同一个 tag 被覆盖推送」这个常态场景下暴露(如 ipass-1.0.0 迭代):
1. 回滚点被静默跳过
原逻辑比较 old_image != image,两边都是 **tag 名**。同 tag 覆盖推送时 tag 名相同
→ 判为「相同」→ 跳过打标签,只在日志留一句不起眼的「跳过」,等于悄悄失去回滚能力。
改为按**镜像内容 id** 判重(新增 image_id()),并用旧 id 打标签。
实测:同名 tag 但内容不同时,正确产出 ipass-gateway:rollback-<ts>(指向旧内容)。
2. 自动回滚可能选错镜像
原来按 {{.CreatedAt}} 取最新,而 CreatedAt 是镜像的**构建时间**;回滚标签是事后用
image id 补打的,CreatedAt 会很旧(实测标签时间 10:49:54、CreatedAt 10:45:45)
→ 「选最近」反而可能选到旧镜像。改为按 tag 名里的时间戳排序(字典序即时间序)。
验证:本机造「同名 tag、不同内容」的旧容器 → update 正确产出回滚标签并打印回滚命令。
|
2026-09-12 10:50:22 +08:00 |
|
admin
|
6a5387b8ce
|
fix(llm): base_url 端口跟随调用方 Host(修正 .11 上打不通的回显地址)
问题:账号态回的 base_url 不带端口(https://lm.mayishangshu.cn/deepseek/v1),
而本网关在宿主 88 上。客户端照它拼请求会落到 443 —— 实测那是**出口 SSL 设备**,
返回 HTTP 200 + 一个 HTML 登录页:状态码正常、内容完全不对,最难察觉的一种失败。
也不能写死 :88:挂在 443 反代后面时又必须不带端口。
改法:新增 http::host_port()(从 Host 头取 ":88"/""),base_url / view / view_all
接收端口参数,调用方从当前请求取。88 部署给 :88,443 反代给无端口,两种都对。
本轮 .11 实机交付验证:
- 镜像 ipass-1.0.0(digest 046a9dd7…)更新完成:端口 88:18098、网络 ipass_default、
数据目录 /home/train11/ipass/data 全部复刻,3 账号 / 1 域名 / 1 上游无损;worker 可写。
- 给 deepseek 登记 deepseek-chat / deepseek-reasoner(保存时不提交 auth 字段 → 密钥未被动)。
- 两把 Key 实调真实 DeepSeek 均 200,含此前 404 的 /deepseek/v1/chat/completions(去重修复生效)。
- 用量统计按账号/按模型正确累加;账号态自查可用。
文档:§15 对外端口由 :18098 更正为宿主 :88;§16 新增条目;CLAUDE.md 补 base_url 端口约定。
回归:网关 78 + LLM 77 = 155 条全绿(新增 2 条端口自适应断言)。
|
2026-09-12 10:43:11 +08:00 |
|
admin
|
5e8c38aef4
|
feat(deploy): 新增 ipass-agent.py —— 跑在 .11 的远程更新控制面(HTTP)
把 update-ipass.sh 的动作暴露成 HTTP 接口,远端(AI/值班人)不必登录服务器即可
完成「拉镜像 → 重启 → 看日志 → 回滚」,形成「本机构建推送 → 远程自更新 → 自验证」闭环。
- 单文件、仅 Python 标准库(无 Flask/requests);Bearer token 鉴权,token 落
~/.ipass-agent-token(600);--bg 双 fork + setsid 真后台,另有 --stop/--check。
- 端点:/health /check /status /containers /logs /data(脱敏) /jobs[/id] /pull /update
/rollback /restart。
- 变更类接口为异步任务(返 job id,/jobs/<id>?offset=N 增量取日志);
同一时刻只允许一个变更任务,并发返回 409。
- 端口/挂载/网络/env/重启策略全部从旧容器 docker inspect 复刻;自定义 env 保留、
Docker 自带的不照抄;动手前自动备份数据 + 打 rollback-<时间> 标签。
修掉两个真实隐患:
- HTTP/1.1 下鉴权失败的请求体若不消费,残包会被当作下一个请求的请求行 → 响应串包
(已在 _dispatch 开头统一读掉 body)。
- 端口映射同一 host:container 在 inspect 中含 IPv4/IPv6 两条,不去重会重复 -p。
本机用真实流程验证:自动探测 → update 7 步全过(端口/自定义 env 复刻)→ rollback
回到旧镜像 → restart/logs/data 脱敏 → 409 并发保护 → 同连接残包测试 → --bg/--stop。
文档:readme §12.5 / §16、CLAUDE.md 新增「远程控制面」小节。
|
2026-09-12 10:20:49 +08:00 |
|
admin
|
b5386283f7
|
fix(deploy): 更新脚本自检增加「worker 对数据目录可写」检查
写穿 JSON 是正确性要求:worker 是 nobody(65534),数据目录不可写会让
改账号/域名静默失败(接口返回成功但状态未落盘)。启动后 touch 探针验证。
|
2026-09-12 10:12:13 +08:00 |
|
admin
|
e38237dc4a
|
feat(deploy): 新增 .11 一键更新脚本 + 上游多模型/模型发现/用量统计
功能(本轮 5 项需求的落地):
- 上游可挂多模型:llm-upstreams.json 每上游新增 models 清单(仅用于模型发现,不参与路由)
- 模型发现:GET /v1/models(OpenAI {object:list} 形状,网关本地应答)+ /api/v1/models + /api/v1/upstreams
- 用量统计:/api/admin/usage(管理台「用量统计」Tab)+ /api/v1/usage + /me 的 llm_usage 摘要
口径:只统计真正转发出去的请求,401/403/404/429 不计;与配额计数 st: 刻意分开
- 账号展示名 display_name(纯展示,不进 ukey:)
- 修复 /v1 版本段重复拼接(llm::join_target)→ 上游 base 自带 /v1 时不再 404 空体
- 修复删账号未清用量键(stats::forget)
部署脚本 deploy/update-ipass.sh:
- 拉镜像 → tar 备份数据 → 删旧容器 → 按旧容器复刻端口/挂载/网络起新容器 → 自检
- 参数从 docker inspect 静态配置读取(docker port 对停止态容器返回空,会让端口静默回落)
- 端口按 host:container 去重(inspect 同一映射含 IPv4/IPv6 两项,重复 -p 会 address already in use)
- --bg 用 setsid/start_new_session 真正脱离会话(仅 nohup & 会被父进程组连带杀掉)
- 旧镜像自动打 rollback-<时间> 标签,收尾打印回滚命令
回归:bash tests/run.sh all → 网关 78 + LLM 75 = 153 条断言全绿。
文档:readme §12.4 / §15 / §16、CLAUDE.md 常用操作 + 排障速查已同步。
|
2026-09-12 10:09:56 +08:00 |
|
admin
|
94a48bef6e
|
部署持久化 deploy/:目录结构 + 空 domains.json + 脱敏模板入库
- .gitignore 由整体排除 deploy/ 改为精确排除真实凭据(users.json/llm-upstreams.json)
与 36MB 内置凭据镜像包(*.tar.gz),保留模板与空 domains.json 可入库
- 新增 users.json.example / llm-upstreams.json.example(占位符,部署时填真实凭据)
- 红线:admin 口令哈希/API Key、上游真 Key、镜像包 仍只进镜像/本地,不入库
|
2026-09-11 16:36:01 +08:00 |
|
admin
|
6955cf845e
|
Dockerfile 运行层补齐 conf/正式证书/管理台/种子数据,可直接 docker run 生产
- 新增 .dockerignore(排除 rust/target 596M 等,构建上下文减脂)
- data 目录 chown nobody:nogroup(worker 默认用户,状态写穿需要可写)
- 种子数据 deploy/data-seed/(含密钥,已 gitignore,只进镜像不入库)
|
2026-09-11 16:17:46 +08:00 |
|
admin
|
eea0a15b9c
|
部署构建配置:.dockerignore / .gitignore(deploy) / Dockerfile 镜像分层
- 新增 .dockerignore,构建上下文减脂(排除 build/tests/.run/data/logs/rust/target 等)
- .gitignore 排除 deploy/:种子数据含 API Key 与上游真 Key,只进镜像不入库
- Dockerfile 将 conf/nginx.conf、conf/tls/、www/、deploy/data-seed/ 拷入镜像
凭据与正式证书不进版本库,随镜像分发时勿推公共仓库
|
2026-09-11 16:15:39 +08:00 |
|
admin
|
0b1d983cac
|
定位更名:尚数网 统一网关(原「公司统一动态域名解析出口」)
- readme 头部改为统一网关定位,明确两类能力:动态域名、LLM API 路由,预留未来扩展
- CLAUDE.md / compose.yml / Cargo.toml description / lib.rs 模块注释同步更名
|
2026-09-11 15:58:41 +08:00 |
|
admin
|
b080edf1b8
|
管理台标题改为「尚数网 山海关」(登录页 title/h1/顶栏 3 处)
|
2026-09-11 15:50:28 +08:00 |
|
admin
|
5c307ba1aa
|
iPass 山海关:Rust 动态模块版全量入库
- vanilla nginx + Rust 动态模块(取代 OpenResty+Lua),共享内存为运行期真源
- 三域名分流 18098 ssl:mdm 管理台 / lm LLM 代理 / *.dm 企业转发,共用 *.mayishangshu.cn 通配符证书(证书不入库)
- LLM 统一出口:同 Key 鉴权、上游 Key 替换、白名单、限流配额、SSE
- 回归夹具 tests/(网关 55 + LLM 34 = 89 断言,夹具 cp 覆盖重置)
- 文档:readme(16 章)+ CLAUDE.md + conf/tls/README(acme.sh 证书管理、hairpin 环回链路)
|
2026-09-11 15:37:09 +08:00 |
|