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