docs: readme 登记 ipass-1.0.5(健康标记/测试按钮/复制地址)与客户端防错指引

This commit is contained in:
admin committed 2026-09-12 14:53:36 +08:00
1 parent 1b0bde9f72
commit f9cc76d4b4
1 file changed
+7
+7
View File
@@ -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:<slot>`,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:<slot>`,无需常驻探测进程);
状态码从 `$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** 会被原样送给上游厂商 —— 厂商拿到它可反调本网关挂的**全部**上游。