​
Open WebUI 接入指南

Open WebUI 是一个功能丰富的自托管 Web 界面，支持多种 LLM 后端。

​
部署方式

​
Docker 部署（推荐）

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.weelinking.com/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.weelinking.com/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.weelinking.com/v1
OPENAI_API_KEYAPI 密钥您的 weelinking 密钥

​
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.weelinking.com/v1
  - OPENAI_API_KEYS=YOUR_API_KEY

​
自定义模型列表

通过环境变量指定可用模型： 
environment:
  - OPENAI_API_BASE_URL=https://api.weelinking.com/v1
  - OPENAI_API_KEY=YOUR_API_KEY

​
常见问题

​
无法连接 API

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

​
模型列表为空

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