Open WebUI 接入中转站教程

Open WebUI 是一个功能强大的自托管 WebUI，专为 LLM（大语言模型）设计，具有类似 ChatGPT 的界面体验。本教程将指导您如何将 Open WebUI 接入到您的中转站。

📋 系统要求

Docker 和 Docker Compose

至少 4GB RAM

现代浏览器支持

可选：Python 3.8+（用于本地部署）

🚀 部署方式

🐳 Docker 部署（推荐）

快速启动

使用 Docker Compose

创建 docker-compose.yml 文件：

启动服务：

🔧 完整配置示例

高级 Docker Compose 配置

💻 本地部署（Python）

⚙️ 详细配置说明

环境变量配置

变量名	说明	示例值	必需
`OPENAI_API_BASE_URL`	API 基础地址	`https://bestapi.aqi.email/v1`	✅
`OPENAI_API_KEY`	API 密钥	`sk-xxx`	✅
`WEBUI_AUTH`	启用认证	`True`	推荐
`ENABLE_SIGNUP`	允许注册	`True`	❌
`DEFAULT_MODELS`	默认模型列表	`gpt-4o,claude-3-5-sonnet`	❌
`WEBUI_SECRET_KEY`	会话密钥	`random-secret-key`	推荐

获取配置信息

您需要准备以下配置项：

配置项	说明	获取方式
OPENAI_API_KEY	API 认证令牌	注册后在 `API令牌` 页面点击 `添加令牌` 获得（以 `sk-` 开头）
OPENAI_API_BASE_URL	API 服务地址	使用 `https://bestapi.aqi.email/v1`

🎯 可用模型

配置完成后，您可以使用的具体模型和定价信息，请访问：

👉 查看完整模型列表和定价

📱 使用说明

访问界面

Docker: http://your-server-ip:3000

本地: http://localhost:8080

首次使用

打开 Open WebUI 界面

如果启用了认证，创建管理员账户

在设置中配置 API 连接

开始与AI对话

功能特性

✅ 类 ChatGPT 界面体验

✅ 支持多用户管理

✅ 对话历史保存

✅ 文档上传和分析

✅ 图像生成支持

✅ RAG（检索增强生成）

✅ 插件和工具集成

✅ 模型管理和切换

✅ 自定义 Prompt 模板

❓ 常见问题解答

Q: 容器启动失败？

A: 检查以下项目：

Q: 无法连接到API？

A: 检查配置：

确认 OPENAI_API_BASE_URL 包含 /v1 后缀

验证 API 密钥格式

测试网络连接

检查防火墙设置

Q: 无法上传文件？

A: 可能的解决方案：

检查文件大小限制

确认文件类型支持

验证存储空间

查看容器权限设置

Open WebUI 接入中转站教程

📋 系统要求#

🚀 部署方式#

🐳 Docker 部署（推荐）#

快速启动#

使用 Docker Compose#

🔧 完整配置示例#

高级 Docker Compose 配置#

💻 本地部署（Python）#

⚙️ 详细配置说明#

环境变量配置#

获取配置信息#

🎯 可用模型#

📱 使用说明#

访问界面#

首次使用#

功能特性#

❓ 常见问题解答#

Q: 容器启动失败？#

Q: 无法连接到API？#

Q: 无法上传文件？#