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