From f9cc76d4b485cebb6f1bd90e5d38171297143f26 Mon Sep 17 00:00:00 2001 From: admin Date: Sat, 12 Sep 2026 14:53:36 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20readme=20=E7=99=BB=E8=AE=B0=20ipass-1.0?= =?UTF-8?q?.5=EF=BC=88=E5=81=A5=E5=BA=B7=E6=A0=87=E8=AE=B0/=E6=B5=8B?= =?UTF-8?q?=E8=AF=95=E6=8C=89=E9=92=AE/=E5=A4=8D=E5=88=B6=E5=9C=B0?= =?UTF-8?q?=E5=9D=80=EF=BC=89=E4=B8=8E=E5=AE=A2=E6=88=B7=E7=AB=AF=E9=98=B2?= =?UTF-8?q?=E9=94=99=E6=8C=87=E5=BC=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- readme.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/readme.md b/readme.md index b2e86f9..8ed49cf 100755 --- a/readme.md +++ b/readme.md @@ -660,6 +660,7 @@ DRY_RUN=1 bash deploy/release.sh 1.0.3 # 只构建不推送 | `ipass-1.0.2` | 写共享内存失败必须出声(三处 `sync_shm` 不再丢弃返回值,`reload_shm` 增加「期望条数 vs 实际装载」核对)——热路径无回源兜底,静默失败等于「刚配好却 404/401 且日志无痕」。 | | `ipass-1.0.3` | 管理台「新建 / 更新 LLM 上游」表单的上游地址、密钥输入框独占整行(原被网格压到 ~170px,地址与密钥看不全)。 | | `ipass-1.0.4` | **LLM 出站请求头改为「默认不放行」**(`proxy_pass_request_headers off` + 凭据头抹空 + 显式放行清单),堵住网关自己的 Key 经 `x-api-key` 泄漏给上游厂商。详见 `docs/llm/UPSTREAM_PROTOCOL_AND_AUTH.md`。 | +| `ipass-1.0.5` | **上游健康自动标记 + 管理台连通性测试 + 可复制 API 地址**。健康数据来自真实流量(log 阶段写 `uh:`,4xx=活、5xx/502/504=失效、下次成功自愈);「测试」按钮内部重定向复用 LLM 转发链路真探测;上游列表 OpenAI/Anthropic 复制按钮与 `anthropic_base_url`;统计挪进独立「数据总览」tab。 | --- @@ -888,6 +889,12 @@ curl -s -H "X-API-Key: $KEY" "$API/api/v1/usage" ## 16. 变更记录 +- **2026-09-12(续2)上游健康自动标记 + 连通性测试 + 复制地址(`ipass-1.0.5`)** + - 健康标记在 log 阶段由**真实流量自己当探针**(`uh:`,无需常驻探测进程); + 状态码从 `$upstream_status` 变量读(`r->upstream` 在上游 finalize 时已置空)。 + - 「测试」按钮经 `ngx_http_internal_redirect` 复用 LLM 转发链路;**URI 必须拷进请求池** + (internal_redirect 只浅拷贝 ngx_str_t,栈上 String 返回即悬垂——实测踩坑)。 + - 客户端防错指引进 §15(`ANTHROPIC_AUTH_TOKEN` vs `ANTHROPIC_API_KEY`、`/anthropic` 段)。 - **2026-09-12(续)LLM 出站头「默认不放行」+ 统一注册(`ipass-1.0.4`)** - **修复凭据泄漏(安全)**:LLM location 此前只覆写 `Authorization`,客户端放在 `x-api-key` 里的**网关自己的 Key** 会被原样送给上游厂商 —— 厂商拿到它可反调本网关挂的**全部**上游。