Open WebUI 接国内大模型 API 怎么配？管理员常问的 5 个问题
Open WebUI 添加 OpenAI 兼容连接：URL 要不要带 /v1、验证失败、模型不出现、Docker 地址、多人 Key，逐条给答案。
Open WebUI 在「Settings → Admin → Connections」里加一条 OpenAI 兼容连接就能接不墨 Router：URL 填 https://router.bumo.cc/v1，Key 填 Router Key，模型会自动从 /models 读出来。 下面按管理员最常问的 5 个问题拆开。
核验日期：2026-10-25。当天 Router 的 /v1/models 返回 28 个模型；本文的模型 ID 都来自这份列表。
1. 到底在哪里加连接？
用管理员账号进入 Settings → Admin → Connections，找到 Manage OpenAI API Connections，点 ➕ Add Connection，填 URL 和 API Key 后保存。
这是实例级配置，只有管理员能改。普通用户在侧边栏看不到这个入口，他们看到的是管理员配好的模型。
2. URL 要不要带 /v1？
要。填 https://router.bumo.cc/v1，不要写到 /chat/completions，也不要在末尾加斜杠。
Open WebUI 会在这个地址后面自己拼 /models 和 /chat/completions。填到完整端点会拼出重复路径，填根域名则少了 /v1。官方文档里 DeepSeek 的示例也是 https://api.deepseek.com/v1，规则相同。
3. Verify Connection 失败，或者模型没出现？
先确认 API Key 没有多余空格，并且有余额。Open WebUI 的验证请求打的是 /models；Router 支持这个接口并返回模型列表，正常情况下点 Verify Connection 会直接通过。
如果验证失败，但聊天仍然要试，可以把模型 ID 手动加进 Model IDs 允许列表再保存。Open WebUI 官方也说明：验证失败不一定代表不兼容，有些服务商只是没实现 /models 或用别的方式鉴权。
手动添加时同样要填完整 ID：
deepseek/deepseek-flashglm/glm-5.3-flashqwen/qwen3.8-flashkimi/kimi-k3.1-pro
4. 模型列表太长，怎么只留几个？
在连接的 Model IDs 里逐个添加你需要的 ID，保存后模型选择器就只显示这些。Router 现在有 28 个模型，全部展开会让人选不过来，也没法按团队用途收口。
添加时注意空格会被去掉，重复 ID 会被拒绝。先加两三个常用模型，跑通再扩。
5. Docker 部署有什么要改的？
不用改。Router 是公网 HTTPS 地址，容器里照填 https://router.bumo.cc/v1 即可。
host.docker.internal 只适用于「模型服务跑在宿主机上」的场景，例如本机 Ollama。把它套到公网地址上反而会解析失败。
如果 Open WebUI 挂在反向代理后面，聊天流式输出异常、控制台报 CORS 或 WebSocket 错误，先按官方 Connection Errors 文档检查 WEBUI_URL、CORS_ALLOW_ORIGIN 和会话 Cookie 配置；那是部署层问题，不是模型地址填错。
补充：多人共用时 Key 怎么算？
管理员在 Connections 里填的是一条实例级连接，所有用户共用这个 Key，用量和余额都记在 Router 同一个账号下。
想让每个人用自己的 Key，可以用 Open WebUI 的 Direct Connections：管理员先在 Admin → Connections 里打开，用户再到自己的 Settings → Connections 填 URL 和 Key，请求从浏览器直接发往模型服务。这个功能官方标注为实验性，开启前先确认版本支持，并注意浏览器跨域限制。
Router 的接口返回了允许跨域的响应头，但不同版本、不同网络环境仍可能表现不一致；遇到问题时先回到实例级连接，确保主流程可用。
先跑通一次
保存连接后，新建一个对话，选 deepseek/deepseek-flash，发一句短消息。有回复再去 Router 用量记录核对这次调用。不要用长文档做第一次测试，失败时不容易分清是配置问题还是上下文超限。
边界
本文核对的是 Open WebUI 官方连接文档、官方 Connection Errors 文档和 Router 当日公开模型列表，没有在你的实例上代填配置，也没有使用付费 Key 做实际推理。不同 Open WebUI 版本的菜单文案可能略有差异。
前往不墨 Router 获取 Key。已经有 Open WebUI 的话，最短路径就是加一条连接、填两个字段、保存。
