Open WebUI 接入指南
Open WebUI 是一个功能丰富的自托管 Web 界面,支持多种 LLM 后端。
部署方式
Docker 部署(推荐)
docker run -d -p 3000:8080 \
-e OPENAI_API_BASE_URL=https://api.yutaikeji.cn/v1 \
-e OPENAI_API_KEY=YOUR_API_KEY \
-v open-webui:/app/backend/data \
--name open-webui \
ghcr.io/open-webui/open-webui:main
Docker Compose
version: '3.8'
services:
open-webui:
image: ghcr.io/open-webui/open-webui:main
ports:
- "3000:8080"
environment:
- OPENAI_API_BASE_URL=https://api.yutaikeji.cn/v1
- OPENAI_API_KEY=YOUR_API_KEY
volumes:
- open-webui:/app/backend/data
restart: unless-stopped
volumes:
open-webui:
配置说明
环境变量
| 变量 | 说明 | 值 |
|---|---|---|
| OPENAI_API_BASE_URL | API 地址 | https://api.yutaikeji.cn/v1 |
| OPENAI_API_KEY | API 密钥 | 您的 weelinking 密钥 |
Web 界面配置
部署完成后,也可以在 Web 界面中配置:
- 登录 Open WebUI
- 进入 设置 → 连接
- 在 OpenAI API 部分填入配置信息
添加模型
方式一:自动获取
点击 刷新模型列表 自动获取可用模型。
方式二:手动添加
在模型管理页面手动添加:
gpt-4o
gpt-4-turbo
claude-3-opus-20240229
claude-3-sonnet-20240229
gemini-2.5-pro
功能特色
- 用户管理:支持多用户、权限控制
- 对话历史:自动保存所有对话
- 文档上传:支持 RAG 问答
- 模型参数:可调节温度、最大 Token 等
- API 集成:可作为其他应用的后端
高级配置
启用多模型
environment:
- ENABLE_OLLAMA_API=false
- ENABLE_OPENAI_API=true
- OPENAI_API_BASE_URLS=https://api.yutaikeji.cn/v1
- OPENAI_API_KEYS=YOUR_API_KEY
自定义模型列表
通过环境变量指定可用模型:
environment:
- OPENAI_API_BASE_URL=https://api.yutaikeji.cn/v1
- OPENAI_API_KEY=YOUR_API_KEY
常见问题
无法连接 API
- 检查 API 地址是否正确(需要包含
/v1) - 确认 API Key 有效
- 检查 Docker 网络配置
模型列表为空
手动在设置中添加模型名称。