Open WebUI 完整指南5 步跑通自托管離線 AI 助手【免費(fèi)下載鏈接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)項(xiàng)目地址: https://gitcode.com/GitHub_Trending/op/open-webui家里那臺(tái)機(jī)器上跑著 Ollama模型能離線推理但你只能對(duì)著命令行提問文檔扔不進(jìn)去想分給家人用又不知道從哪下手——這就是你卡住的地方。Open WebUI 是一個(gè)自托管的 AI 對(duì)話界面設(shè)計(jì)上就為了完全離線運(yùn)行Ollama、OpenAI 兼容 API 都能接一條 Docker 命令裝好之后你的對(duì)話記錄、上傳的文檔、全部設(shè)置都存在自己硬盤上不經(jīng)過(guò)任何云端。這篇文章帶你 10 分鐘部署完 Open WebUI講透你日常用得最多的三個(gè)功能再給 4 條踩坑速查。10 分鐘部署兩條命令就夠 前置要求只有三個(gè)裝好 Docker、至少 4GB 內(nèi)存、一個(gè)可用的模型來(lái)源本機(jī) Ollama 或任一 OpenAI 兼容 API。然后一條命令拉起容器docker run -d -p 3000:8080 \ --add-hosthost.docker.internal:host-gateway \ -v open-webui:/app/backend/data --name open-webui \ --restart always ghcr.io/open-webui/open-webui:main這里-v open-webui:/app/backend/data千萬(wàn)別省它把數(shù)據(jù)庫(kù)掛到命名卷里容器刪了重建數(shù)據(jù)也不丟。模型不在本機(jī)或不用 Ollama 的話加一個(gè)-e OLLAMA_BASE_URL你的模型服務(wù)地址即可。等容器起來(lái)瀏覽器打開http://localhost:3000注冊(cè)第一個(gè)賬號(hào)——它就是管理員賬號(hào)。部署后最常碰的三個(gè)功能模型下拉框一換本地和云端隨便混左邊欄頂部就是模型選擇框本機(jī) Ollama 的模型、任何 OpenAI 兼容接口LM Studio、vLLM、Groq 都行都掛在同一份列表里切換不用改任何配置。它還支持多模型對(duì)話一次把兩三個(gè)模型拉進(jìn)同一屏答案并排對(duì)比選誰(shuí)留誰(shuí)一目了然。把資料喂給知識(shí)庫(kù)AI 答題開始有出處 在知識(shí)庫(kù)頁(yè)面上傳 PDF、文檔Open WebUI 會(huì)自動(dòng)分塊、向量化之后提問時(shí) AI 會(huì)引用庫(kù)里的內(nèi)容作答走的是向量 BM25 混合檢索背后支持 9 種向量數(shù)據(jù)庫(kù)。對(duì)話里輸入#還能直接把某個(gè)網(wǎng)頁(yè)拽進(jìn)上下文。這部分實(shí)現(xiàn)可以看 知識(shí)庫(kù)檢索源碼。調(diào)校到合身離線、超時(shí)與工具擴(kuò)展?? 三個(gè)最常改的地方純離線設(shè)置環(huán)境變量HF_HUB_OFFLINE1它會(huì)停止嘗試從網(wǎng)上拉模型內(nèi)網(wǎng)環(huán)境必開。響應(yīng)超時(shí)Ollama 生成默認(rèn) 5 分鐘超時(shí)慢機(jī)或大上下文可以調(diào)AIOHTTP_CLIENT_TIMEOUT秒放寬更多運(yùn)行參數(shù)集中在 后端啟動(dòng)配置。工具擴(kuò)展這是第三個(gè)高頻功能——內(nèi)置代碼解釋器可以直接在聊天里跑 Python再加網(wǎng)頁(yè)搜索、自定義 Tools/Skills 或接 MCP 工具服務(wù)器AI 就從會(huì)說(shuō)話變成會(huì)干活。內(nèi)置工具的實(shí)現(xiàn)入口在 工具插件目錄。踩坑速查4 個(gè)高頻問題現(xiàn)象打開頁(yè)面報(bào) Server Connection Error。解法容器夠不到宿主機(jī)的 Ollama127.0.0.1:11434給 docker run 加--networkhost端口變 8080或把OLLAMA_BASE_URL指向局域網(wǎng) IP。現(xiàn)象重建容器后賬號(hào)、對(duì)話全沒了。解法啟動(dòng)時(shí)漏了數(shù)據(jù)卷掛載參數(shù)按上面那條命令補(bǔ)上-v open-webui:/app/backend/data?，F(xiàn)象長(zhǎng)回答或慢模型突然斷開、超時(shí)。解法默認(rèn) 5 分鐘生成超時(shí)不夠用調(diào)大AIOHTTP_CLIENT_TIMEOUT環(huán)境變量?，F(xiàn)象界面里 Ollama 報(bào)錯(cuò)、行為怪異。解法先把 Ollama 升到最新版再核對(duì) 設(shè)置 → 常規(guī) 里的 Ollama Server URL 是否填對(duì)。最后一步現(xiàn)在就把它跑起來(lái)打開終端把那條 docker run 命令貼進(jìn)去執(zhí)行等半分鐘訪問http://localhost:3000注冊(cè)賬號(hào)你的離線 AI 助手就有了第一間辦公室。【免費(fèi)下載鏈接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)項(xiàng)目地址: https://gitcode.com/GitHub_Trending/op/open-webui創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考