- 模型加 mode 字段(vendor 默认 / passthrough 新增),shm payload 扩为 4 字段 base\nkey\nasset_id\nmode;旧数据零迁移(无 mode → vendor) - 拆 location 而非按 mode 分支:/apixp/ 不施加 vendor 强约束 (proxy_method POST + 强制 Content-Type + proxy_pass_request_headers off 是 location 级指令,无法按请求级 shm 的 mode 动态切换) - handler 校验路径前缀 vs mode 一致(vendor slug 走 /apixp/ → 404,反之亦然), 避免 vendor 条目继承 passthrough 强制 Content-Type 致 415 之类静默故障 - passthrough:方法/请求体/Content-Type 原样透传(含 multipart),上游路径 = base + /apixp/<slug> 之后的 URI 尾部(含 query 由模块拼,变量式 proxy_pass 不自动追加);Key 可空(内部服务免鉴权,下发时 nginx 空串 = 不发该头) - 探测按 mode 分流:vendor 走 POST 预估 / passthrough 走 GET 打上游根地址 - nginx:lm server 加 /apixp/,mdm server 加 /_apixp_probe/(internal) - 测试 §11.6 新增 35 条断言(鉴权/路径转发/体透传/Key 下发/路径-mode 一致 /管理台回显/探测);账号态 count 1→3 同步;回归 225/0 全绿 - 管理台:列表加 mode 标签、表单加 mode 下拉 + 透传说明 + 路径示例复制 - 文档:docs/apix/PASSTHROUGH_MODE.md 真源(决策/兼容/改动一览) OCR 是第一条 passthrough 配置:/apixp/ocr/ocr、/apixp/ocr/ocr/base64、 /apixp/ocr/ocr/url?src=...
51 lines
1.4 KiB
JSON
51 lines
1.4 KiB
JSON
{
|
|
"items": {
|
|
"search": {
|
|
"supplier": "vendor-a",
|
|
"asset_id": "searxng-search",
|
|
"base": "http://127.0.0.1:18999",
|
|
"key": "ak_test_supplier_key",
|
|
"name": "SearXNG 免费搜索",
|
|
"desc": "服务端聚合 Google / Brave / Bing",
|
|
"params": ["q"],
|
|
"enabled": true,
|
|
"created_at": 1750000000
|
|
},
|
|
"offline": {
|
|
"supplier": "vendor-a",
|
|
"asset_id": "disabled-asset",
|
|
"base": "http://127.0.0.1:18999",
|
|
"key": "ak_test_supplier_key",
|
|
"name": "已停用的代理",
|
|
"desc": "enabled=false,热路径必须查不到",
|
|
"params": [],
|
|
"enabled": false,
|
|
"created_at": 1750000000
|
|
},
|
|
"ocr": {
|
|
"supplier": "internal-ocr",
|
|
"asset_id": "",
|
|
"base": "http://127.0.0.1:18999",
|
|
"key": "",
|
|
"mode": "passthrough",
|
|
"name": "内部 OCR 服务(空 Key 透传)",
|
|
"desc": "多端点透传:/ocr、/ocr/base64、/ocr/url,内部服务免鉴权",
|
|
"params": [],
|
|
"enabled": true,
|
|
"created_at": 1750000000
|
|
},
|
|
"ocrk": {
|
|
"supplier": "internal-ocr",
|
|
"asset_id": "",
|
|
"base": "http://127.0.0.1:18999",
|
|
"key": "ak_internal_ocr_key",
|
|
"mode": "passthrough",
|
|
"name": "内部 OCR 服务(带 Key 透传)",
|
|
"desc": "同上,但上游需要 X-API-Key,验证透传模式下 Key 会被下发",
|
|
"params": [],
|
|
"enabled": true,
|
|
"created_at": 1750000000
|
|
}
|
|
}
|
|
}
|