外观
Open WebUI
应用介绍
Open WebUI 是一个可自行部署的网页聊天平台，可为个人或团队提供统一的模型选择、对话和用户管理界面。它适合需要通过浏览器集中使用模型，或由管理员为多名用户统一维护模型连接的场景。本教程由管理员添加 OpenAI 兼容连接，使用户能够选择模型聚合服务平台提供的模型。
准备信息
text
Base URL：https://ai.example.edu.cn/v1
API Key：模型聚合服务平台中创建的 API Key
模型 ID：以模型广场中显示的模型标识为准本教程配置的是 Open WebUI 后端的共享连接，需要使用 Open WebUI 管理员账号。
1. 部署并打开 Open WebUI
已经部署好 Open WebUI 的团队可以直接跳到下一步。
使用 Docker 快速启动：
bash
docker pull ghcr.io/open-webui/open-webui:main
docker run -d \
-p 3000:8080 \
-v open-webui:/app/backend/data \
--name open-webui \
--restart always \
ghcr.io/open-webui/open-webui:main然后在浏览器中打开：
text
http://localhost:3000open-webui 数据卷用于保存账号、聊天记录和设置，重新创建容器时不要遗漏。生产环境应使用固定版本镜像并按照本单位要求配置域名、HTTPS、认证和备份。更多安装方式请查看 Open WebUI 官方快速入门。
2. 打开管理员连接设置
使用管理员账号登录 Open WebUI，打开设置窗口，然后进入管理员区域：
- 点击编号 1 的 Connections。
- 找到编号 2 的 Manage OpenAI API Connections。
- 点击编号 3 的加号 ＋。
不同版本的导航层级可能显示为 Settings → Admin → Connections 或 Admin Panel → Settings → Connections，但都应在管理员设置的 OpenAI API 连接区域添加。
不要进入普通用户的 Direct Connections
本文配置的是服务器端共享连接。普通用户设置中的 Direct Connections 是另一项功能，只有管理员启用后才能让用户各自保存 API Key，不适合由管理员配置团队统一连接。
3. 填写连接信息
在 Add Connection 或 Edit Connection 窗口中按编号填写：
| 编号 | Open WebUI 字段 | 填写内容 |
|---|---|---|
| 4 | URL | https://ai.example.edu.cn/v1 |
| 5 | Auth / Bearer | 你的 API Key |
| 6 | Model IDs | qwen3.6-27b |
| 7 | ＋ | 将输入的模型 ID 加入列表 |
| 8 | Save | 保存连接 |
截图已经按照本文接入信息填写为 https://ai.example.edu.cn/v1 和 qwen3.6-27b。
填写时请注意：
- URL 以
/v1结尾，不要填写/v1/chat/completions。 - Auth 保持
Bearer，密钥框中只粘贴 API Key，不要手动添加Bearer前缀。 - Headers 留空，除非模型聚合服务平台另有明确要求。
- Prefix ID 可选。连接多个平台且模型重名时，可以设置前缀帮助区分。
- Provider Type 使用
OpenAI。OpenAI 兼容服务在 Open WebUI 中也通过该类型连接。
4. 设置可用模型
如果平台的 /v1/models 接口可用，Model IDs 可以留空，Open WebUI 会自动读取模型列表。
团队部署更建议配置模型白名单：
- 在 Add a model ID 中输入
qwen3.6-27b。 - 点击编号 7 的 ＋。
- 根据需要继续添加其他模型。
- 点击 Save。
这样可以避免把平台上的所有模型都展示给 Open WebUI 用户，也能在模型自动发现不可用时手动指定模型。
保存后确认连接右侧的开关处于启用状态。如果界面提供刷新或验证按钮，可以先执行连接验证；看到连接成功提示后返回聊天页面。
5. 选择模型并验证
返回 Open WebUI 首页并新建对话：
- 点击页面顶部当前模型名称。
- 搜索并选择刚才允许的模型 ID。
- 发送一条不含敏感数据的测试消息。
text
请回复“连接成功”，并说明你当前使用的模型名称。能够持续收到正常回复，即表示 Open WebUI 到模型聚合服务平台的连接已经生效。
配置路径、字段含义和 Model IDs 用法参考 Open WebUI 官方 OpenAI-Compatible 指南。本文界面截图取自 Open WebUI 官方文档仓库。
配置过程中遇到账号、API Key、接口地址、模型权限、额度、限流或通用错误时，请查看常见问题（FAQ）。