
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 環境。下面這條命令做三件事拉官方鏡像并后臺啟動、把容器 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 默認監聽 127.0.0.1:11434。裝好 Ollama、拉一個模型界面模型列表里直接能選。模型在遠程服務器加一個OLLAMA_BASE_URL環境變量指向遠程地址即可其余參數照抄最簡命令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是賬號、對話、設置的唯一落盤處項目官方文檔把它列為必選項。重建容器前記得備份這個卷。離線環境沒外網的機器加-e HF_HUB_OFFLINE1系統就不會再去嘗試從 Hugging Face 下載模型。改端口-p 3000:8080冒號左邊是外部端口改成任意空閑端口即可右邊的 8080 是容器內部端口別動。 踩坑速查端口被占與連接失敗現象3000 端口被占起不來。原因本機已有服務占著 3000。 解法-p 3000:8080換成-p 8080:8080瀏覽器訪問地址同步改。現象界面里看不到本機 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現象容器一重建賬號和對話全沒了。原因啟動時漏掛了數據卷。 解法確認命令里有-v open-webui:/app/backend/data之后定期備份該卷。現在就把第一條命令跑起來幾分鐘后你會有一個完全跑在本地機器上、能接任意模型的聊天界面。想往下深挖看這兩處就夠后端源碼在 backend/open_webui/安全策略見 docs/SECURITY.md。【免費下載鏈接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)項目地址: https://gitcode.com/GitHub_Trending/op/open-webui創作聲明:本文部分內容由AI輔助生成(AIGC),僅供參考