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