141,904· 20,396 forks· Python· NOASSERTION自托管

Open WebUI - 開源 AI 聊天介面平臺

open-webui/open-webui

支援 Ollama 和 OpenAI API 的全功能自託管 AI 對話平臺,內建 RAG、多模型並行、許可權管理等企業級特性

成熟度維護極活躍,最近提交0天前,貢獻者842人,但存在400個未關閉issues,需關注穩定性

项目体检

部署 · docker compose 一键部署,包含 ollama 和 open-webui 两个服务,默认端口 3000(可通过 OPEN_WEBUI_PORT 环境变量修改),支持 :ollama 和 :cuda 标签镜像

成本 · 基础运行仅需 Docker,可开箱即用;接入外部 LLM 需配置 OPENAI_API_KEY 等;完整 RAG 功能需选配 9 种向量数据库之一(ChromaDB/PGVector/Qdrant 等);图像生成需 AUTOMATIC1111 或 ComfyUI 后端

技术 · Python 后端 + Svelte 前端,FastAPI 提供 API 服务,支持 SQLite/PostgreSQL 数据库,可选 S3/GCS/Azure Blob 云存储,集成 OpenTelemetry 可观测性

许可 · NOASSERTION(许可证未明确声明),商用前需联系项目方确认授权,建议查阅官方文档或咨询法务

活跃 · 最新版本 v0.9.6 发布于 2026年6月1日,842 名贡献者,代码最近提交于今日,社区极度活跃

解決什麼

Open WebUI 解決了企業和個人在私有化部署 AI 對話服務時面臨的三大痛點:首先是資料主權問題 - 通過完全離線執行能力,敏感對話資料無需上傳雲端;其次是多模型整合難題 - 統一介面同時接入 Ollama 本地模型、OpenAI、Claude、Gemini 等商業 API,甚至支援多模型並行對話取長補短;第三是知識庫增強 - 內建 RAG(檢索增強生成)引擎,支援 9 種向量資料庫和多種文件解析引擎(Tika/Docling/OCR),讓 LLM 能檢索本地文件庫回答專業問題。專案還提供企業級許可權管理、SSO 單點登入、SCIM 自動化使用者配置等功能,填補了開源 AI 介面在生產環境部署的空白。

為何火

14 萬 GitHub 星標背後是三個核心優勢:技術棧完整性 - 從前端 Svelte UI 到後端 FastAPI,從 SQLite 到 PostgreSQL,從本地儲存到 S3 雲端儲存,提供生產級全棧方案;功能豐富度超預期 - 不僅是簡單的聊天介面,還整合語音視訊通話(支援 Whisper/Azure/ElevenLabs 等多家 TTS/STT 服務)、影像生成編輯(DALL-E/ComfyUI)、Web 搜尋(15+ 搜尋引擎)、Python 函式呼叫工具等高階特性;部署靈活性 - 既可 Docker 單機部署,也支援 Kubernetes 生產環境,既能純離線執行 Ollama,也能混合接入商業 API。對比 ChatGPT 等商業服務動輒每月 20 美元訂閱費,自託管方案對成本敏感使用者和資料合規要求高的場景極具吸引力。

核心功能

多模型聚合對話:同一介面同時呼叫 GPT-4、Claude、本地 Llama 模型,系統自動路由或使用者手動選擇,甚至可讓多個模型同時回答同一問題做對比。RAG 知識庫:上傳 PDF/Word/網頁等文件到本地庫,對話時用 #文件名 引用,LLM 會檢索相關內容回答;支援 ChromaDB、Qdrant、Milvus 等 9 種向量資料庫,可根據資料規模選型。許可權與使用者組:管理員可建立細粒度角色(如只讀使用者、模型建立者),限制特定使用者只能訪問指定模型,適合多租戶場景。

語音影片互動:內建 WebRTC 支援,可語音提問(Whisper 本地轉寫或呼叫 Azure/Deepgram API)、語音播報回答(ElevenLabs/OpenAI TTS),甚至視訊通話模式。Web 增強:對話中輸入 #https://example.com 自動抓取網頁內容注入上下文;或配置 SearXNG/Brave Search 等搜尋引擎,讓 LLM 即時檢索最新資訊。模型構建器:Web 介面直接建立 Ollama Modelfile,調整系統提示詞、溫度引數,或從 Open WebUI Community 匯入社群分享的角色預設。

企業整合:LDAP/Active Directory 身份驗證、SCIM 2.0 自動同步 Okta/Azure AD 使用者、OAuth SSO 登入;Google Drive/OneDrive 檔案選擇器直接匯入雲端文件;OpenTelemetry 輸出 traces/metrics 到 Prometheus/Jaeger 監控系統。

安裝

Docker Compose(推薦):克隆倉庫後 docker compose up -d 即可,預設啟動 Ollama 後端(埠 11434)和 Open WebUI 前端(埠 3000)。若已有外部 Ollama 服務,修改 OLLAMA_BASE_URL 環境變數。僅 Open WebUI:不需要本地 Ollama 時執行 docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main,通過 Web 介面配置 OpenAI API Key 即可使用商業模型。

Kubernetes 部署:官方提供 Helm Chart,支援 Ingress、持久卷、多副本等生產配置。原始碼安裝:需 Python 3.11+、Node.js,後端 pip install -r requirements.txtbash start.sh,前端 npm install && npm run build。中國大陸使用者注意:Docker 映象託管在 ghcr.io,可能需配置映象加速;Ollama 模型下載建議設定 OLLAMA_HOST 代理或使用國內映象站。

適合誰

企業內網 AI 服務:金融、醫療等對資料合規要求嚴格的行業,可部署在內網伺服器,員工通過 LDAP 賬號登入使用,對話資料不出內網。個人知識庫助手:研究人員上傳論文 PDF 到 RAG 庫,寫作時隨時 #論文標題 引用文獻內容;程式設計師匯入專案文件,用自然語言查詢 API 用法。多模型評測對比:AI 應用開發者需要測試不同模型效果,Open WebUI 的並行對話功能可同時向 GPT-4/Claude/Gemini 傳送相同 prompt 對比輸出質量。

成本敏感使用者:用 Ollama 跑開源模型(Llama/Mistral)完全免費,僅需本地算力;偶爾需要 GPT-4 時再配置 API Key 按需呼叫,比訂閱 ChatGPT Plus 靈活。不適合純小白:雖然 Docker 部署簡化了流程,但配置 RAG 向量資料庫、除錯 SSO 整合、最佳化 Prompt 模板仍需一定技術背景;且 400 個未關閉 issues 顯示專案在快速迭代中可能遇到相容性問題。

社群評價

HN 討論熱度適中(29 點贊),核心爭議在於架構設計:有使用者質疑"為什麼不做成純前端 SPA 儲存在瀏覽器本地,而必須 Docker 部署後端?" 認為這降低了便攜性。開發者回應稱後端承擔 RAG 向量檢索、模型路由、許可權管理等複雜邏輯,純前端無法實現;但社群確實出現了 fork 專案(如 mnpenner/chatgpt)嘗試純靜態頁面方案,證明輕量級需求存在市場。

正面評價集中在功能完整度 - "終於有開源專案做到 ChatGPT 的 90% 功能還能自託管",特別是 RAG 和多模型支援被認為是殺手級特性。負面意見指出複雜度成本:全功能部署需要配置向量資料庫、物件儲存、監控系統等一堆基礎設施,"對於只想本地跑 Llama 聊天的使用者過於重型"。中立觀察者認為專案定位在"企業級 AI 平臺"而非"ChatGPT 簡單替代",理解目標使用者後評價會更客觀。

選型對比

vs ChatGPT Plus:Open WebUI 一次部署成本(伺服器+時間)約等於 ChatGPT 半年訂閱費,但長期使用免費(僅電費/伺服器成本);資料完全私有,可接入內部知識庫;劣勢是需自行維護,模型效果取決於選用的 LLM(開源模型通常弱於 GPT-4)。

vs LM Studio:LM Studio 是桌面應用,側重本地模型推理;Open WebUI 是 Web 服務,支援多使用者、許可權管理、遠端訪問,更適合團隊協作。兩者可配合使用:LM Studio 做推理後端,Open WebUI 做前端介面。

vs Dify/LangChain:Dify 偏向低程式碼 AI 應用搭建,LangChain 是開發框架;Open WebUI 是開箱即用的終端使用者產品。如果需求是"給非技術人員提供 ChatGPT 式介面",Open WebUI 更合適;若要開發定製 AI 工作流,Dify/LangChain 更靈活。

vs 純 Ollama Web UI:市面上有多個輕量級 Ollama 前端(如 Chatbot UI),Open WebUI 的差異在於企業級特性 - SSO、RBAC、審計日誌、雲端儲存等,代價是部署複雜度高 3-5 倍。

已知坑

許可證不明確:GitHub 顯示 NOASSERTION,README 未明確宣告開源協議,商用前務必聯絡官方確認(企業版頁面暗示基礎版可能有使用限制)。資源消耗:完整部署(Ollama + Open WebUI + PostgreSQL + ChromaDB)至少需 8GB 記憶體,執行 7B 引數模型推理再加 6-8GB;樹莓派等低功耗裝置僅適合純 API 轉發模式。

向量資料庫遷移:切換 RAG 後端(如 ChromaDB 換 Qdrant)需重新索引所有文件,專案未提供遷移工具。中文 OCR 支援:預設 Tika 對中文 PDF 識別率一般,建議配置 PaddleOCR 或 Mistral OCR;但這些需額外部署服務,文件說明不夠詳細。OAuth 配置複雜:社群反饋 Azure AD/Okta 整合需反覆除錯 redirect URI 和 scope,官方文件示例不全,建議參考 GitHub issues 中的實戰案例。

更新頻率雙刃劍:0 天前還在提交程式碼說明迭代極快,但 400 個 open issues 也意味著 bug 修復可能滯後;生產環境建議鎖定 LTS 版本(企業版特性)而非追 main 分支。移動端體驗:雖然支援 PWA,但複雜操作(如批次上傳文件、除錯 Prompt 模板)在手機上仍

安装方式:docker