Open WebUI

Open WebUI是什麼

Open WebUI 是一款可自托管的 AI 聊天、知識庫和團隊協作平台，常被用來為 Ollama 本地模型提供瀏覽器介面，也能連接 OpenAI、Anthropic、Gemini、Azure、vLLM 以及其他 OpenAI 或 Open Responses 相容服務。

用戶可以在統一介面管理多模型對話、文件 RAG、網路搜尋、語音、圖片生成、工具及自動化任務。

Open WebUI 不包含一個可以直接替代所有模型的自研大模型。它是模型與用戶之間的應用層，實際的回答品質、速度、上下文以及價格，都取決於所連接的推理服務。

使用本地的 Ollama 可以讓主要資料保留在自己的裝置或伺服器上；而使用雲端模型或外部工具時，相關內容會被傳送到對應的供應商那裡。

Open WebUI核心功能

多模型統一聊天

管理員可接入多個本地和雲端模型，用戶能在同一會話中切換模型或並排比較回覆。聊天支援檔案和圖片上傳、消息隊列、資料夾、標籤、置頂、記憶、語音輸入輸出與多種內容操作。

模型預設可綁定系統提示詞、知識庫、工具和參數，形成面向寫作、教學、編程或客服的專用助手。

Ollama與本地模型

Open WebUI 可以連接到主機或遠端伺服器上的 Ollama，也有內建了 Ollama 的整合式容器鏡像。在本地進行推論時，不需要支付雲端 API 的費用，但會消耗 CPU、GPU、記憶體、儲存空間以及電力。

容器內的 localhost 指向容器本身，連接宿主機 Ollama 時應使用正確的宿主機地址並限制監聽範圍。

知識庫與RAG

用戶可上傳文件、建立知識集合，在聊天中讓模型檢索相關片段。系統支援向量檢索、關鍵字與向量混合檢索、重排、完整內容注入以及多種文件抽取引擎。

外部知識來源還可直接連接 Qdrant、Milvus 或 pgvector，避免重新擷取已有索引。

如果 Ollama 模型的上下文仍使用較小的預設值，大量檢索內容可能會被截斷，從而導致 RAG 效果不佳。部署者需要根據模型的能力來調整上下文、切分方式、召回數量以及重排順序，並以標準問題來檢查答案與引用資料的正確性，而不能僅僅看文件是否成功上傳。

聯網搜尋與網頁內容

Open WebUI 可接入 SearXNG、Google、Tavily 等搜尋服務，並將網頁內容作為模型上下文。搜尋結果的準確性、數量及隱私權皆由對應的引擎決定。

面對新聞、價格、政策與專業資訊，用戶仍應打開原始頁面核驗時間與上下文。

MCP、OpenAPI與工具

平台可連接 HTTP MCP、透過代理連接 stdio MCP，也能從 OpenAPI 標準中發現外部介面。Workspace Tools 是直接在 Open WebUI 進程內運行的 Python 代碼，功能相當強大，但這等於賦予了伺服器執行代碼的能力；

只有可信管理員才能創建或導入。

社群工具的熱門或精選狀態並不代表其已經過過安全審查。安裝之前應先閱讀程式碼、檢查相關的依賴項目及金鑰的使用情況，並限制工作區的權限。

對於需要更強隔離或獨立擴縮容的任務，優先將工具作為外部 MCP 或 OpenAPI 服務運行。

函數與擴展系統

Pipe Function 可用於新增模型供應商或自訂請求邏輯，Filter 可在訊息傳輸前後執行脫敏、格式化、限流及日誌處理，Action 則可用於新增訊息按鈕。舊版的 Pipelines 專案仍可與現有的部署環境相容，但官方已將其標記為舊有方案，新專案應優先使用 Functions、Tools 或外部工具伺服器。

代碼、圖像、語音與自動化

Open WebUI 可以連接瀏覽器端的 Python、隔離式的 Open Terminal、圖像生成服務、語音辨識與語音合成功能。此外，它還支援定時執行指令、結構化的任務清單以及訊息通知功能。

當程式碼執行或終端工具能夠存取實際的檔案與網路時，應使用隔離容器、資源限制以及每個使用者的權限限制；而瀏覽器沙箱則不能被視為完整的防護措施。

團隊管理與API

管理員可以管理使用者、群組、模型存取權限、公告、使用分析、盲測以及 Webhook。平台提供具有使用者權限的 API Key，以及用於聊天、檔案、知識庫和工具調用的各種介面。

金鑰繼承創建者權限，應限制可訪問端點、設定過期策略並定期輪換。

Open WebUI版本與費用對比

標準自託管服務無需支付軟體訂閱費用，但伺服器、模型及第三方服務則不一定免費。若需企業專用版、強化品牌形象、專屬功能或進行正式的企業合作，則需要取得許可證，官方並未公開固定價格，需根據組織規模和席位數量來詢價。

模型接入方式對比

Open WebUI許可證說明

目前的官方許可證是基於 BSD 3-Clause 條款所制定的，同時還增加了對品牌保護的要求。若在內部環境中使用，且能完整保留 Open WebUI 的原始品牌標識，則可以免費使用。

若部署在任意連續 30 天內不超過 50 名用戶，可按官方條件調整品牌；實質貢獻者獲得書面許可或購買企業許可證時也可獲得相應品牌權限。

超出免費例外範圍的白標服務、強調品牌形象的設計、將自有 Logo 與官方品牌並列展示，或是使用企業專有的功能，都需取得企業許可證。許可證的內容可能會隨著專案版本的更新而改變，因此在發布修改版、為客戶部署或進行大規模商業應用之前，應先確認所使用的版本所附帶的許可證條款及官方說明。

Open WebUI Docker部署教學

1. 安裝Docker：在 Windows、macOS 或 Linux 上安裝官方 Docker 環境，確認可拉取官方鏡像。
2. 選擇鏡像：標準鏡像適合多數用戶，slim 鏡像體積較小，cuda 鏡像支援 NVIDIA GPU，ollama 鏡像包含 Ollama。
3. 建立持久卷：將資料目錄對應到容器內的後端資料路徑，避免在重建容器時遺失資料庫、聊天記錄和知識庫。
4. 啟動並創建管理員：首次打開本機 3000 連接埠所註冊的帳戶將成為管理員。請勿在公開網路上保留無人認領的首次註冊頁面。
5. 連接模型：配置 Ollama 地址或雲端模型 Base URL 與密鑰，先測試普通對話和流式輸出。
6. 配置RAG：選擇文檔抽取、Embedding 與向量庫，用少量中文資料檢查解析和檢索品質。
7. 加固服務：關閉不需要的註冊，配置 HTTPS、強密鑰、反向代理、防火牆、訪問控制與備份。
8. 固定生產版本：main 與 latest 是滾動鏡像，生產環境應固定具體版本標籤，升級前備份並閱讀遷移說明。

Open WebUI使用教學

建立可重複使用的專業工作流

1. 把複雜主題拆成背景、數據、比較和結論四類問題；
2. 組合多模型統一聊天、Ollama與本地模型與知識庫與RAG形成固定研究步驟；
3. 優先使用官網、論文、監管文件和原始數據；
4. 對高風險結論設置第二人複核；
5. 保存查詢、證據、版本和未解決的問題；
6. 資料變化後重新運行並更新結論；

大規模部署注意事項

• 單實例可使用預設資料庫和本機儲存；
• 多實例生產部署需要PostgreSQL、Redis、可並發訪問的向量數據庫和共享檔案儲存；
• 每個實例必須使用一致的Secret與連接配置，資料庫遷移只能由一個實例執行；
• 還應設置模型限流、審計日誌、資源配額、備份恢復和升級回滾流程；

適合哪些用戶

• 希望為 Ollama 或其他本地模型增加完整網頁聊天界面的個人；
• 需要統一接入多個雲端與自託管模型的 AI 團隊；
• 計劃搭建內部文件問答、搜尋和模型門戶的組織；
• 需要 MCP、OpenAPI、Python 工具以及消息過濾擴展的開發者；
• 具備能力管理身分、基礎設施和資料安全的私有化部署團隊。

優勢與使用限制

• OpenWebUI的優勢在於介面成熟、模型相容範圍廣、私有化能力強，並整合了知識庫、工具、搜尋、語音、圖像及團隊管理功能；
• 它適合從個人本地聊天平滑擴展到組織內部平台；
• 限制在於功能多、配置面廣，生產運維複雜度不低；
• 插件可以執行任意代碼，錯誤權限可能危及伺服器；
• 自託管不自動等於安全或合規；
• 模型回答和RAG引用仍可能錯誤，關鍵內容必須人工核驗；
• 升級前要備份數據，並優先安裝包含安全修復的穩定版本；

常見問題

Open WebUI免費嗎

標準的自托管方式以及保留原始品牌的內部使用是免費的。至於伺服器、GPU、雲端模型 API 以及第三方服務則需另行計費。

白標、重品牌與企業專屬能力需要詢價購買企業許可證。

Open WebUI必須安裝Ollama嗎

不必。它既能連接 Ollama，也能直接連接 OpenAI 相容的服務、Open Responses 以及多種雲端模型服務。

Open WebUI支援MCP嗎

支援 HTTP MCP，也可透過代理接入 stdio MCP。外部服務的代碼與權限需要另行審計。

Open WebUI可以完全離線嗎

可以，但必須使用本地模型、本地 Embedding、本地向量庫，並關閉網路搜尋及所有外部 API。安裝鏡像和下載模型的階段通常仍需網路。

Open WebUI適合公網部署嗎

可以，但必須配置 HTTPS、身分驗證、強效的密碼、反向代理、防火牆、備份以及最小權限原則。切勿將預設連接埠或具有高權限的插件直接暴露在公網上。