跳到主要内容

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_URLAPI 地址https://api.yutaikeji.cn/v1
OPENAI_API_KEYAPI 密钥您的 玉兔AI 密钥

Web 界面配置​

部署完成后，也可以在 Web 界面中配置：

  1. 登录 Open WebUI
  2. 进入 设置 → 连接
  3. 在 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​

  1. 检查 API 地址是否正确（需要包含 /v1）
  2. 确认 API Key 有效
  3. 检查 Docker 网络配置

模型列表为空​

手动在设置中添加模型名称。