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