Commit Graph
9 Commits
Author SHA1 Message Date
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 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 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