admin
|
762d308745
|
test+deploy: 探针改目录驱动 + 三态判定 + 发版失败自动回滚(镜像+数据)
两件事:
1) 验证脚本统一从 /api/v1/me 拉能力目录(新增 tests/me_catalog.py 共享模块)。
之前 slot×模型、apix 条目写死在脚本里——配置是管理台动态的,改配置后探针
要么漏验新上游、要么拿旧模型名误报。现在 test_models 按 upstreams×models
全展开(both 双格式并发),apix_check 按目录逐条探;拉不到目录退出码 2
(验证失效 ≠ 上游没问题,不许假绿)。
三态口径:❌ 网关侧故障(错误体归属 + HTTP 码 + error.code 值三重判据——
智谱 401 体也是 {"error":{code,message}} 形状,光看形态会把欠费误判成发版
故障);⚠️ 上游/厂商侧(欠费 402、不可达 502/504、WAF、200 软错误)
**如实汇总反馈但不染红发版**;网关 429 限流按 GW_WARN 处理。
live_check.sh 退出码语义固定:0 过 / 1 网关侧故障 / 2 验证不可用。
分类器 15 个边界场景离线单测全对(撞形状/码集合/软错误/不误伤正常 200)。
2) agent.sh release 改 4/4 步:验证失败不再停在原地——
抓 PRE_IMG + update job 的备份路径 → live_check → rc=1 时自动
POST /rollback {tag, restore_backup} 回滚镜像并恢复 data/audit,回滚后
再跑 verify 自检;rc=2(验证不可用)**不回滚**(盲回滚比带病观察危险)。
ipass-agent 1.0.2:rollback 本地无镜像自动 pull(自动路径不许卡「先手动拉」);
新增 restore_data——先 stop 容器(防周期落盘把污染写回)、备份 tar 解包顶替
data/audit、现目录改名 .broken-<ts> 留证、只认 ~/ipass/backup/ 下的 tar。
restore_data 本地单测过(恢复/留证/staging 清理/越界拒绝)。
release 开头加控制面版本闸门:<1.0.2 会静默忽略 restore_backup → 中止
(IPASS_FORCE_RELEASE=1 可跳过),⚠️ 线上控制面还是 1.0.1,发版前先上 .11
跑 §12.5 自更新。
附带修 bash 老坑:`$VAR` 紧跟全角字符被吞进变量名(unbound variable,
live_check A 路径实测炸出),统一 ${VAR}。
线上实测:live_check 三步全绿(LLM 10/10 目录全展开 + apix 3/3 + 验收)。
只动 tests/deploy,不进镜像;ipass-agent 属控制面(跑宿主),需单独自更新。
|
2026-09-17 08:41:48 +08:00 |
|
admin
|
391ccfbd1a
|
chore(deploy): agent.sh 加 upstream-save 子命令 + 修 upstream-test 抓真实状态码
- upstream-save <slot> <base> <base_anthropic>:直连网关改双协议地址,
auth/models/enabled 保持原值(凭据只从 .env 读,走统一白名单入口)
- upstream-test 改用 -w '%{http_code}' 抓 internal_redirect 后的上游真实状态码
(旧解析器把上游原始响应当 JSON 包装,拿不到状态码,glm/qwen 等验证失真)
|
2026-09-16 18:32:31 +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
|
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
|
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
|
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 |
|