Open WebUI 连接外部模型失败
Open WebUI 的 OpenAI 兼容连接配置与常见错误。，附原因排序、修复步骤与责任判定。
更新 2026-10-28
核验 2026-10-28 · 码农阿风
open-webui自部署
30 秒结论
Open WebUI 的 OpenAI 连接 URL 要写到 /v1，且容器内要能访问到。
报错原文对照
Connection error
Model not found原因排序
| 概率 | 原因 |
|---|---|
| 45% | URL 没写 /v1 |
| 30% | 容器网络访问不到宿主机 |
| 25% | Key 错 |
修法
先在自己这边查
- URL 写到 /v1
- 容器里用 host.docker.internal 或宿主机 IP
- 检查 Key
再往服务方查
这一项不是你这边能解决的。
责任判定表
| 现象 | 责任方 |
|---|---|
| 宿主机能通、容器不行 | 容器网络 |
| 404 | URL |
| 401 | Key |
什么时候该换
Docker 里 localhost 指的是容器自己。
你在这个站点上遇到过这个问题？
认领站点后可补充证据、申请公开核验；认证不改榜单排序，只对应可复核的检测与复测。
认领 / 申请认证