项目介绍

Open WebUI 是一个功能丰富、用户友好的开源 AI 聊天界面,使用 Python(后端)和 Svelte(前端)开发。它最初作为 Ollama 的 Web UI 项目诞生,如今已发展成为一个支持多种 LLM 后端的通用 AI 交互平台。在 GitHub 上拥有超过 12.6 万颗星标,是目前最受欢迎的开源 AI 界面项目之一。

Open WebUI 的设计理念是完全自托管离线可用。你可以在自己的服务器或本地电脑上部署,所有数据都保留在你的控制范围内。它提供了类似 ChatGPT 的使用体验,同时具备更多高级功能,如 RAG(检索增强生成)、MCP 工具调用、知识库管理、多用户权限控制等。

无论你是想为团队搭建私有 AI 平台,还是想在本地拥有一个功能完善的 AI 助手界面,Open WebUI 都是一个绝佳选择。它与 Ollama 和 OpenAI 兼容 API 无缝集成,让你可以同时使用本地模型和云端模型。

项目信息详情
开发团队Open WebUI Community
GitHub Stars126,672+
官方网站openwebui.com
开源协议BSD-3-Clause
后端语言Python(FastAPI)
前端框架Svelte / SvelteKit
部署方式Docker(推荐)/ pip / 源码

核心特性

直觉化界面

受 ChatGPT 启发的现代聊天界面,支持 Markdown 渲染、代码高亮、LaTeX 数学公式、HTML 预览等富文本功能。

多模型支持

同时连接 Ollama 本地模型和 OpenAI 兼容 API,支持在对话中切换模型,甚至多模型并行对话比较。

RAG 知识库

内置检索增强生成功能,支持上传文档(PDF、Word、TXT 等)构建知识库,让 AI 基于你的数据回答问题。

MCP 工具调用

支持 Model Context Protocol(MCP),让 AI 调用外部工具和服务,扩展能力边界。

多用户管理

内置用户注册和权限控制系统,支持管理员、普通用户等角色,适合团队和企业部署。支持 OAuth/OIDC 单点登录。

完全自托管

一条 Docker 命令即可部署,数据完全在你的掌控之下。支持离线运行,适合对数据安全有要求的场景。

  • 语音交互 — 支持语音输入和 TTS 语音输出,提供自然的对话体验。
  • 图像生成 — 集成 AUTOMATIC1111、ComfyUI、OpenAI DALL-E 等图像生成后端。
  • 对话分享 — 支持生成对话分享链接,方便团队协作和知识传播。
  • 插件系统 — 支持自定义 Pipelines 和 Functions,可扩展 AI 的工具调用能力。
  • Web 搜索 — 集成 DuckDuckGo、Google、Brave 等搜索引擎,支持联网搜索增强回答。
  • 移动端适配 — 响应式设计,支持安装为 PWA 应用,提供接近原生的移动体验。
  • 国际化 — 支持多种语言界面,包括中文、英文、日文等。

支持的后端与模型

Open WebUI 支持多种 AI 后端,你可以灵活选择和组合:

Ollama(本地模型)

无缝集成 Ollama,运行 Llama、DeepSeek、Qwen、Gemma、Mistral 等开源模型。完全离线,数据不出本地。

OpenAI 兼容 API

支持 OpenAI、Anthropic Claude、Google Gemini、Groq、Together AI 等任何 OpenAI API 兼容服务。

Pipelines 扩展

通过 Pipelines 插件系统接入更多后端,包括 LangChain、LlamaIndex 等框架,以及自定义的 AI 服务。

图像生成

集成 AUTOMATIC1111 Stable Diffusion、ComfyUI、OpenAI DALL-E 等图像生成服务,在对话中生成图片。

快速开始

方式一:Docker 部署(推荐)

使用 Docker 是最简单的部署方式,一条命令即可启动:

# 如果 Ollama 运行在本机
docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

# 如果不使用 Ollama,仅使用 OpenAI API
docker run -d -p 3000:8080 \
  -e OPENAI_API_KEY=your_secret_key \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

# 捆绑 Ollama 一起启动(GPU 支持)
docker run -d -p 3000:8080 \
  --gpus all \
  -v ollama:/root/.ollama \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:cuda

方式二:pip 安装

# 需要 Python 3.11+
pip install open-webui

# 启动服务
open-webui serve

方式三:从源码构建

git clone https://github.com/open-webui/open-webui.git
cd open-webui

# 构建前端
cd frontend && npm install && npm run build && cd ..

# 安装后端依赖并启动
pip install -r requirements.txt
bash start.sh

启动后,在浏览器中访问 http://localhost:3000 即可开始使用。首次访问需要注册管理员账号。

常见问题

Open WebUI 和 ChatGPT 有什么区别?
ChatGPT 是 OpenAI 的云端服务,而 Open WebUI 是一个可以自己部署的开源项目。它提供类似 ChatGPT 的界面体验,但数据完全由你控制。你可以连接本地 Ollama 模型(完全免费)或各种云端 API 服务。
Open WebUI 需要 Ollama 才能运行吗?
不需要。Open WebUI 支持多种后端,你可以仅使用 OpenAI API 或其他兼容服务,无需安装 Ollama。当然,如果你想完全本地化运行,搭配 Ollama 是最佳选择。
Open WebUI 支持多人同时使用吗?
支持。Open WebUI 内置完整的用户管理系统,支持多用户注册、角色权限控制(管理员/用户)、OAuth/OIDC 单点登录等,非常适合团队或企业使用。
Open WebUI 可以离线使用吗?
可以。如果搭配 Ollama 使用本地模型,整个系统可以完全离线运行。如果使用 OpenAI 等云端 API,则需要联网访问 API 服务。
Open WebUI 对硬件有什么要求?
Open WebUI 本身非常轻量,任何能运行 Docker 的设备都可以部署。硬件要求主要取决于你运行的模型大小。如果仅作为前端连接云端 API,普通配置即可。如果搭配 Ollama 运行本地模型,建议至少 8GB 内存。

社区议题

以下是该项目当前开放的 Issue(按评论数排序),展示社区最关注的话题。标题已翻译为中文供参考。

编号 议题标题(中文翻译 / 英文原文) 创建日期 评论
#13464 增强:笔记功能
enh: notes
2025-05-03 39
#1225 功能请求:支持双因素认证(2FA/MFA TOTP)
feat: 2FA/MFA TOTP support
2024-03-20 37
#8262 功能请求:原生桌面应用
feat: native desktop app
增强需要帮助
2025-01-02 32
#1008 增强:更多键盘快捷键
enhancement: more keyboard shortcuts
增强好的入门需要帮助
2024-03-03 26
#19313 功能请求:用户级别的 MCP 请求头
feat: User specific MCP headers
2025-11-20 25
#12228 功能请求:上传文件时不经过后端处理
feat: uploading files without backend processing
2025-03-31 25
#5894 功能请求:OpenAI 实时 API 支持
feat: openai real-time api
2024-10-03 23
#15162 [缺陷] 多 Worker 环境下 WebSocket/API 路由不匹配导致无法直连聊天
issue: Unavailable direct connection chat with multiple workers due to WebSocket/API routing mismatch
缺陷需要帮助
2025-06-20 22
#8050 增强:频道功能
enh: channels
2024-12-25 22
#2904 功能请求:分享对话的访问权限控制
feat: authentication control for shared chats
2024-06-07 22
#6311 增强:嵌入失败时的通知和处理机制
enh: Notification and Handling for Failed Embeddings
2024-10-21 21
#19225 [缺陷] 聊天记录无法显示,一直处于加载状态
issue: Chat history cannot be displayed and remains loading indefinitely
缺陷需要帮助
2025-11-17 20
#21024 [缺陷] Open WebUI 无法区分图像编辑和图像创建提示
issue: Open WebUI does not distinguish the difference between image editing and image creation prompts
缺陷
2026-01-29 19
#19840 [缺陷] RedisCluster 在停止任务时 publish 调用失败
issue: Bug: RedisCluster publish Fails on POST /api/tasks/stop/{task_id}
缺陷
2025-12-09 19
#21340 功能请求:完整支持 Open Responses
feat: full open responses support
2026-02-12 18
#17678 [缺陷] OAuth token 超时后工具调用中丢失
issue: OAuth token after some time missing in tool calls
缺陷
2025-09-23 18
#12619 功能请求:聊天和知识库使用不同的内容提取设置
feat: Different content extraction settings for chat and knowledge-base
2025-04-08 18
#3237 增强:从后端调用 outlet hook
Enh: call outlet hook from the backend
2024-06-17 18
#15261 [缺陷] WEBUI_AUTH_TRUSTED_EMAIL 对部分 API 请求不再生效
issue: WEBUI_AUTH_TRUSTED_EMAIL apparently stopped working for at least some api requests
缺陷
2025-06-24 17
#14157 [缺陷] 切换模型时不会取消之前选中的工具
issue: Switching models in chat does not deselect previously selected tools
缺陷需要帮助
2025-05-22 15
#5872 功能请求:数据源集成
feat: data sources
增强
2024-10-02 15
#21564 [缺陷] "编辑"和"继续生成"功能无法正常工作
issue: "Edit" and "Continue Response" don't work properly
缺陷
2026-02-18 14
#16217 功能请求:允许在聊天模式中编辑推理/思考部分
feat: Allow Editing of Reasoning/Thinking Section in Chat Mode
2025-08-01 14
#13137 功能请求:知识库支持图片导入、OCR 识别和图片显示
feat: Knowledge Base Enhancement: Support for Image Import, OCR Recognition, and Image Display
2025-04-22 14
#20896 [缺陷] 通过 WebUI 路由 Ollama 时工具调用后生成停止
issue: Generation stops after tool call when routing Ollama through WebUI
缺陷
2026-01-23 12
#20302 [缺陷] 代码块中的换行符莫名消失
issue: Newlines in Codeblocks Mysteriously Disappear
缺陷已确认
2025-12-31 11
#22267 [缺陷] HTML 预览在某些模型的 thinking 块中渲染代码块
issue: HTML Preview renders code blocks inside thinking blocks for certain models
缺陷
2026-03-05 10
#12087 [缺陷] 粘贴大量内容时浏览器卡死
issue: Browser Freezes When Pasting Large Content
缺陷已确认
2025-03-26 10
#6692 增强:内置使用量追踪/限制功能
enh: open webui built-in usage tracking/limit
2024-11-04 10
#5962 增强:提示词管理与版本控制
enh: prompt management w/ version control
2024-10-07 10