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 Stars | 126,672+ |
| 官方网站 | openwebui.com |
| 开源协议 | BSD-3-Clause |
| 后端语言 | Python(FastAPI) |
| 前端框架 | Svelte / SvelteKit |
| 部署方式 | Docker(推荐)/ pip / 源码 |
受 ChatGPT 启发的现代聊天界面,支持 Markdown 渲染、代码高亮、LaTeX 数学公式、HTML 预览等富文本功能。
同时连接 Ollama 本地模型和 OpenAI 兼容 API,支持在对话中切换模型,甚至多模型并行对话比较。
内置检索增强生成功能,支持上传文档(PDF、Word、TXT 等)构建知识库,让 AI 基于你的数据回答问题。
支持 Model Context Protocol(MCP),让 AI 调用外部工具和服务,扩展能力边界。
内置用户注册和权限控制系统,支持管理员、普通用户等角色,适合团队和企业部署。支持 OAuth/OIDC 单点登录。
一条 Docker 命令即可部署,数据完全在你的掌控之下。支持离线运行,适合对数据安全有要求的场景。
Open WebUI 支持多种 AI 后端,你可以灵活选择和组合:
无缝集成 Ollama,运行 Llama、DeepSeek、Qwen、Gemma、Mistral 等开源模型。完全离线,数据不出本地。
支持 OpenAI、Anthropic Claude、Google Gemini、Groq、Together AI 等任何 OpenAI API 兼容服务。
通过 Pipelines 插件系统接入更多后端,包括 LangChain、LlamaIndex 等框架,以及自定义的 AI 服务。
集成 AUTOMATIC1111 Stable Diffusion、ComfyUI、OpenAI DALL-E 等图像生成服务,在对话中生成图片。
使用 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
# 需要 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 即可开始使用。首次访问需要注册管理员账号。
以下是该项目当前开放的 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 |