Open WebUI 接入 EXAIV:自托管 AI 界面的模型配置指南
在 Open WebUI(原 Ollama WebUI)中把 EXAIV 配置为 OpenAI 兼容连接:界面配置与 Docker 环境变量两种方式、模型列表加载、多模型启用,以及常见连接错误的排查。
Open WebUI 接入 EXAIV:自托管 AI 界面的模型配置指南
Open WebUI 是最流行的自托管 AI 对话界面,支持接入任意 OpenAI 兼容端点。把它连到 EXAIV,你就得到一个「自己的 ChatGPT 界面 + 国产模型后端」的组合:对话记录留在自己服务器,模型用 EXAIV 目录里的(Kimi、GLM 等)。本篇给出界面配置和 Docker 环境变量两种方案。
方式一:界面配置(推荐新手)
进入管理设置
以管理员身份登录 Open WebUI,右上角头像 → Admin Settings(管理设置)。打开连接配置
左侧选 Connections(连接)→ 找到 OpenAI 区块。填写地址和密钥
API Base URL 填https://exaiv.com/api/ai/v1;API Key 填 EXAIV 控制台生成的 Key。保存并选择模型
保存后新建对话,在模型下拉里选择要用的模型(如kimi-k3);若列表为空,用下面的方式手动添加。
模型列表没有出现?
Open WebUI 通常会尝试从端点拉取模型列表;如果没拉到,可以在连接的模型管理里手动添加模型 ID——以 EXAIV 的 /models 目录实时数据为准,填目录里真实存在的 ID。
方式二:Docker 环境变量
容器部署时可以直接用环境变量注入连接信息:
bash
docker run -d -p 3000:8080 \
-e OPENAI_API_BASE_URL="https://exaiv.com/api/ai/v1" \
-e OPENAI_API_KEY="你的EXAIV Key" \
-v open-webui:/app/backend/data \
--name open-webui \
ghcr.io/open-webui/open-webui:main
环境变量以官方文档为准
不同 Open WebUI 版本的环境变量名可能调整(如 OPENAI_API_BASE_URL 与 OPENAI_API_BASE 的历史差异)。以你部署版本的官方文档为准,本文给的是当前常见写法。
验证与排查
| 现象 | 检查项 | 修复 |
|---|---|---|
| 连接测试失败 | Base URL 是否完整到 /api/ai/v1 | 补全或修正路径 |
| 401 | Key 是否正确、无空格 | 重新生成并粘贴 |
| 模型列表空 | 端点是否支持列表接口 / 手动添加 | 手动填目录真实模型 ID |
| 回复超时 | 网络链路 | 检查服务器出网、重试 |
推荐配置组合
| 用途 | 模型 | 说明 |
|---|---|---|
| 日常助手、长文总结 | kimi-k3 | 长上下文能力 |
| 工具调用、多轮任务 | glm-5.3-flash | 编排稳定 |
| 轻量快速对话 | 目录中轻量模型 | 以 /models 实时为准 |
自托管的边界
Open WebUI 解决了「界面自托管」,但模型推理仍在 EXAIV 服务器完成——对话内容会发送到你配置的端点。如果你的需求是「数据完全不离开机房」,需要的是本地模型部署方案(GGUF + Ollama),而不是换一个前端。
FAQ
Open WebUI 和 Ollama 是什么关系?
Open WebUI 原是 Ollama 的网页界面,后来发展成支持多种后端的通用界面:既可以连本机 Ollama,也可以连任意 OpenAI 兼容端点(如 EXAIV)。两者不冲突,可以同时配置。
模型列表拉不出来怎么办?
部分部署环境到 /models 列表接口的请求可能受限。直接在连接设置里手动添加模型 ID 即可,效果相同。
能同时连本地 Ollama 和 EXAIV 吗?
能。Open WebUI 支持多个连接并存,对话时在下拉里选不同来源的模型。本地模型处理敏感任务,云端模型处理需要更强能力的任务,是常见组合。
多用户使用要注意什么?
每个用户共享你的 EXAIV Key 的额度消耗。若团队使用,建议评估用量和权限管理,或为不同用途分配不同 Key。
价格在哪里看?
按 token 计费,实时价格与套餐见定价页;本文只讲配置。
相关阅读
- LobeChat 接入 EXAIV — 另一个对话界面方案
- Cherry Studio 接入 EXAIV — 桌面客户端方案
- Kimi K3 与 GLM 接入指南 — API 完整教程
- Qwen GGUF 本地部署入门 — 完全本地化方案
- 定价 — 实时价格与充值套餐