Open WebUI 安裝配置完全攻略一條命令跑起本地大模型界面【免費下載鏈接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)項目地址: https://gitcode.com/GitHub_Trending/op/open-webui本地模型能跑了可對著終端敲命令對話實在不是人干的活——想要一個像樣的聊天界面嗎Open WebUI 就是一個自托管 AI 平臺接上 Ollama 或任意 OpenAI 兼容接口本地大模型立刻有臉可看全程可離線運行。它內置知識庫檢索、插件擴展、多用戶權限管理甚至還有語音通話。但對只想快速跑起來的你記住三件事就夠一條命令裝好、把模型接上、避開幾個高頻坑。 一鍵部署Docker 最簡啟動命令結論先說裝 Docker 就行別碰 Python 環(huán)境。下面這條命令做三件事拉官方鏡像并后臺啟動、把容器 8080 端口映射到本機 3000 端口、掛一個數據卷保存對話記錄這條-v不能省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瀏覽器打開 http://localhost:3000 注冊第一個賬號自動成為管理員就算完成了。更習慣 Python 的話pip install open-webui后運行open-webui serve要求 Python 3.11訪問 http://localhost:8080其余流程一致。 接模型Ollama 與 OpenAI 接口怎么連Open WebUI 自己不跑模型它負責連模型。按模型所在位置分三種情況。模型跑在本機最簡命令里的--add-hosthost.docker.internal:host-gateway就是在告訴容器宿主機的 Ollama 默認監(jiān)聽 127.0.0.1:11434。裝好 Ollama、拉一個模型界面模型列表里直接能選。模型在遠程服務器加一個OLLAMA_BASE_URL環(huán)境變量指向遠程地址即可其余參數照抄最簡命令docker run -d -p 3000:8080 -e OLLAMA_BASE_URLhttps://your-ollama-server.com -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main用 GPU 加速或只接 OpenAI 接口有 NVIDIA 顯卡把鏡像標簽:main換成:cuda并加上--gpus all前提是先裝好 NVIDIA 容器工具包。只接云端 API加-e OPENAI_API_KEY你的密鑰LMStudio、vLLM 這類 OpenAI 兼容服務同理把 BASE_URL 指過去就行。?? 進階開關數據卷、離線與自定義端口數據卷-v open-webui:/app/backend/data是賬號、對話、設置的唯一落盤處項目官方文檔把它列為必選項。重建容器前記得備份這個卷。離線環(huán)境沒外網的機器加-e HF_HUB_OFFLINE1系統(tǒng)就不會再去嘗試從 Hugging Face 下載模型。改端口-p 3000:8080冒號左邊是外部端口改成任意空閑端口即可右邊的 8080 是容器內部端口別動。 踩坑速查端口被占與連接失敗現(xiàn)象3000 端口被占起不來。原因本機已有服務占著 3000。 解法-p 3000:8080換成-p 8080:8080瀏覽器訪問地址同步改?，F(xiàn)象界面里看不到本機 Ollama 的模型。原因容器默認訪問不到宿主機的 127.0.0.1:11434。 解法改用 host 網絡模式重跑此時不再需要--add-host訪問地址變成 http://localhost:8080docker run -d --networkhost -e OLLAMA_BASE_URLhttp://127.0.0.1:11434 -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main現(xiàn)象容器一重建賬號和對話全沒了。原因啟動時漏掛了數據卷。 解法確認命令里有-v open-webui:/app/backend/data之后定期備份該卷?，F(xiàn)在就把第一條命令跑起來幾分鐘后你會有一個完全跑在本地機器上、能接任意模型的聊天界面。想往下深挖看這兩處就夠后端源碼在 backend/open_webui/安全策略見 docs/SECURITY.md?！久赓M下載鏈接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)項目地址: https://gitcode.com/GitHub_Trending/op/open-webui創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考