Open WebUI 深度使用指南：145K Star 的私人 AI 助手到底能做什么
🩺 摘要
📝 详情
如果你在本地跑过 LLM，大概经历过这样的痛苦：模型在终端里跑、聊天没有历史记录、想上传个文件发现不支持、想换个模型要重启服务……
Open WebUI 就是为了解决这些问题而生的。它把 Ollama、vLLM、OpenAI 等后端整合在一个漂亮的 Web 界面里，GitHub Stars 145,830 ⭐，是 2026 年最流行的 AI 前端项目之一。
一句话：Open WebUI = 你自己服务器上的 ChatGPT。
它能做什么
先看看装好之后的日常：
┌─────────────────────────────────────────┐
│ 🧠 AI Chat 📁 文件上传 🔍 搜索 │
│ │
│ ┌──────────────────────────────────┐ │
│ │ 用户：帮我总结这份 PDF │ │
│ │ AI：好的，文件里的核心观点是… │ │
│ │ │ │
│ │ 用户：换 DeepSeek 再分析一次 │ │
│ │ （下拉框选另一个模型，继续聊） │ │
│ └──────────────────────────────────┘ │
│ │
│ 📎 附件：report.pdf ☁️ 已索引 │
│ 🤖 模型：Qwen2.5-7B (当前) │
│ 🛠 工具：网页搜索 ✅ 代码执行 ✅ │
└─────────────────────────────────────────┘
核心功能清单：
| 功能 | 说明 | 竞品对比 |
|---|---|---|
| 多模型支持 | 同时连接 Ollama + OpenAI + 自定义 API | ChatGPT/T3 只能用一个 |
| 对话管理 | 多会话、历史搜索、分享对话 | 不输 ChatGPT Plus |
| 文件上传 | PDF / Word / 图片 / 代码 | ChatGPT 要 Plus 才有 |
| RAG 知识库 | 上传文档后自动建立向量索引 | 专业版功能 |
| 工具集成 | 代码执行、网页搜索、DALL-E | 第三方工具 |
| 多用户 | 团队协作、权限管理 | 适合小团队 |
| MCP 支持 | 连接 MCP Server 扩展能力 | 最前沿的协议支持 |
| PWA | 手机浏览器当 App 用 | 不需要装客户端 |
| 自部署 | 数据全在自己的服务器上 | 隐私第一 |
10 分钟部署
Docker 部署（最快，推荐）
# Mac/Linux
docker run -d -p 3000:8080 \
-v open-webui:/app/backend/data \
-e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
--name open-webui \
--restart always \
ghcr.io/open-webui/open-webui:main
# Windows（PowerShell）
docker run -d -p 3000:8080 `
-v open-webui:/app/backend/data `
-e OLLAMA_BASE_URL=http://host.docker.internal:11434 `
--name open-webui `
--restart always `
ghcr.io/open-webui/open-webui:main
然后打开 http://localhost:3000，注册第一个账号（自动成为管理员）。
不用 Docker？也支持
# 用 pip 安装（需要 Python 3.11+）
git clone https://github.com/open-webui/open-webui
cd open-webui/backend
# 创建虚拟环境
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# 安装依赖
pip install -r requirements.txt
# 启动
sh start.sh
单行脚本
# 官方安装脚本（自动检测系统）
/bin/bash -c "$(curl -fsSL https://openwebui.com/install.sh)"
配置多个模型源
这是 Open WebUI 的杀手特性——同时连接多个后端，在界面上随时切换：
连接 Ollama（本地模型）
# 确保 Ollama 在运行
ollama serve
# Docker 启动时已配置 OLLAMA_BASE_URL
# 进入界面后，设置 → 连接 → Ollama → 自动检测
Open WebUI 会自动发现 Ollama 里所有已安装的模型。模型不够？直接在 Open WebUI 的管理后台搜索下载。
连接 OpenAI（远程模型）
在设置里填：
- API URL: https://api.openai.com/v1
- API Key: sk-...
- 模型列表自动拉取
连接 DeepSeek / 硅基流动 / 任意兼容 API
// 自定义 API 配置
{
"name": "DeepSeek",
"api_url": "https://api.deepseek.com/v1",
"api_key": "sk-xxx",
"models": ["deepseek-chat", "deepseek-reasoner"]
}
{
"name": "硅基流动",
"api_url": "https://api.siliconflow.cn/v1",
"api_key": "sk-xxx",
"models": ["Qwen/Qwen2.5-7B-Instruct", "Pro/deepseek-ai/DeepSeek-V3"]
}
真正的玩法是这样
你写一篇文章：
→ 先用 DeepSeek 写初稿（API，速度快）
→ 切换到 Qwen2.5-14B 润色（本地，隐私保护）
→ 再切回 GPT-4o 检查英文表达（备用远程）
全部在一个对话框里完成，不用切换页面。
RAG 知识库功能
Open WebUI 内置了文档搜索功能。上传 PDF、Word、TXT 等文件后，系统自动提取文本、生成向量索引、存储到内置的 ChromaDB 中。
操作路径：
1. 点击左侧「工作区」→ 创建知识库
2. 上传文档（支持批量上传）
3. 在对话中 #@知识库名称 引用
# 你可以在对话框中写：
请参考 @产品文档 回答：这个功能的技术架构是怎样的？
# AI 会先搜索知识库，再基于搜到的内容回答
十万人用 Open WebUI 的真实场景
| 场景 | 配置 | 效果 |
|---|---|---|
| 个人学习 | Docker + Ollama + Qwen2.5-7B | 免费的 ChatGPT，支持文件上传 |
| 团队协作 | Docker + vLLM + GPT-4o | 内部知识库，隐私合规 |
| 教育机构 | Open WebUI + 班级管理 | 学生用 AI 但不泄露数据 |
| 本地化部署 | 离线部署 | 涉密单位、内网环境 |
一个小彩蛋
Open WebUI 支持语音输入。在设置里开启后，可以直接用麦克风说话。底层用了 Web Speech API，不需要第三方服务。
📊 数据来源：GitHub API 查询时间 2026-07-18。Open WebUI 版本为 0.5.x 系列。
💬 评论 (0)