Open WebUI Docker部署實(shí)戰(zhàn)指南從零到跑通 Ollama 網(wǎng)頁(yè)界面的完整教程【免費(fèi)下載鏈接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)項(xiàng)目地址: https://gitcode.com/GitHub_Trending/op/open-webui想在瀏覽器里跟大模型聊天又不想在本地裝一堆依賴Open WebUI 是一個(gè)開(kāi)源的 AI 網(wǎng)頁(yè)界面直接對(duì)接 Ollama 和 OpenAI 兼容 API用 Docker Compose 一條命令就能把整套服務(wù)拉起來(lái)。這篇文章講清楚從裝到能用的完整流程。一張圖看懂 Open WebUI Ollama 雙容器架構(gòu)說(shuō)白了open-webui 負(fù)責(zé)界面ollama 負(fù)責(zé)跑模型兩者在 Docker 內(nèi)部網(wǎng)絡(luò)里互相對(duì)話。數(shù)據(jù)存在兩個(gè)命名卷里——卷就是 Docker 幫你在宿主機(jī)上管的一塊存儲(chǔ)容器刪了數(shù)據(jù)還在。部署前先給機(jī)器做體檢項(xiàng)目最低要求備注Docker Engine20.10需帶 Compose v2內(nèi)存4GB建議 8GB模型吃內(nèi)存磁盤10GB 空閑裝鏡像和模型權(quán)重網(wǎng)絡(luò)首次需要拉鏡像和模型部署完可離線體檢命令# 一次性檢查 Docker 和 Compose 版本 docker --version docker compose version執(zhí)行后你會(huì)看到兩行Docker 版本號(hào)如27.x和Docker Compose version v2.x.x。缺哪個(gè)先補(bǔ)哪個(gè)。Open WebUI Docker 一鍵部署三步走第一步拿部署文件# 克隆倉(cāng)庫(kù)并進(jìn)入目錄 git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui執(zhí)行后你會(huì)看到目錄里躺著docker-compose.yaml它就是本次部署的主配置。第二步啟動(dòng)兩個(gè)容器# 啟動(dòng) ollama open-webui自動(dòng)建內(nèi)部網(wǎng)絡(luò)和數(shù)據(jù)卷 docker compose up -d執(zhí)行后你會(huì)看到兩個(gè)容器的拉取/構(gòu)建輸出最后出現(xiàn)open-webui Started。首次要構(gòu)建鏡像耐心等幾分鐘。第三步確認(rèn)跑起來(lái)了# 檢查容器狀態(tài) docker compose ps執(zhí)行后你會(huì)看到兩條狀態(tài)為running的容器。瀏覽器打開(kāi)http://localhost:3000注冊(cè)第一個(gè)賬號(hào)它就是管理員。不想手敲 compose 文件的話倉(cāng)庫(kù)里還有個(gè)交互式腳本docker-compose-launcher.sh能自動(dòng)探測(cè) GPU、用參數(shù)選端口和數(shù)據(jù)目錄。按需選裝只挑你要的把入口換成 80 端口誰(shuí)需要3000 端口被占或者想直接用域名 80/443 訪問(wèn)。# 臨時(shí)用 80 端口啟動(dòng)只對(duì)本次生效 OPEN_WEBUI_PORT80 docker compose up -d想永久生效改 docker-compose.yaml 里OPEN_WEBUI_PORT-3000那一行。接外部 Ollama 實(shí)例誰(shuí)需要Ollama 已經(jīng)在別的服務(wù)器上跑著不想重復(fù)拉一個(gè)。# 指定外部 Ollama 地址覆蓋 compose 里的默認(rèn)值 OLLAMA_BASE_URLhttps://ollama.example.com docker compose up -d執(zhí)行后你會(huì)在 compose 輸出里看到OLLAMA_BASE_URL被覆蓋為新地址。把 Ollama API 開(kāi)放給外部工具誰(shuí)需要想用腳本或其他程序直接調(diào)模型接口。# 疊加 api 配置額外暴露 11434 端口 docker compose -f docker-compose.yaml -f docker-compose.api.yaml up -d生產(chǎn)環(huán)境別把這個(gè)端口裸奔前面掛個(gè)反向代理加認(rèn)證。開(kāi)啟 NVIDIA GPU 加速誰(shuí)需要想跑大模型CPU 推理太慢。前提裝了 NVIDIA 驅(qū)動(dòng)和 Container Toolkit。# 疊加 gpu 配置給 ollama 容器分配 1 塊 GPU docker compose -f docker-compose.yaml -f docker-compose.gpu.yaml up -d開(kāi)啟 AMD GPU誰(shuí)需要顯卡是 AMD 的。用 rocm 鏡像 ROCm 驅(qū)動(dòng)。# 疊加 amdgpu 配置換 :rocm 鏡像并映射 GPU 設(shè)備 docker compose -f docker-compose.yaml -f docker-compose.amdgpu.yaml up -d指定數(shù)據(jù)存放位置誰(shuí)需要想備份、遷移數(shù)據(jù)或者嫌命名卷看不見(jiàn)摸不著。# 把 ollama 數(shù)據(jù)改到宿主機(jī)目錄 OLLAMA_DATA_DIR./ollama-data docker compose -f docker-compose.yaml -f docker-compose.data.yaml up -d執(zhí)行后你會(huì)看到./ollama-data目錄被創(chuàng)建模型權(quán)重直接躺在里面方便打包和遷移。 翻車急救包卡住了照這個(gè)查癥狀容器起不來(lái)反復(fù)重啟排查一條docker compose logs --tail50 open-webui解法最常見(jiàn)是端口被占日志里會(huì)有port is already allocated換端口或殺掉舊進(jìn)程提示權(quán)限錯(cuò)誤就重建數(shù)據(jù)卷再啟動(dòng)。癥狀WebUI 提示找不到 Ollama排查一條docker compose exec ollama ollama list解法容器里列不出模型說(shuō)明 WebUI 指錯(cuò)地址了。確認(rèn)OLLAMA_BASE_URL在 compose 網(wǎng)絡(luò)內(nèi)應(yīng)為http://ollama:11434別寫成 127.0.0.1。癥狀模型跑得慢日志顯示 CPU 推理排查一條docker run --rm --gpus all nvidia/cuda:12.1.1-base-ubuntu22.04 nvidia-smi解法沒(méi)有輸出就是 Docker 看不到 GPU重裝 NVIDIA Container Toolkit 并重啟 Docker 服務(wù)再用 gpu 配置啟動(dòng)。癥狀想確認(rèn)服務(wù)健康、想備份數(shù)據(jù)排查一條docker inspect --format{{.State.Health.Status}} open-webui解法輸出healthy即正常鏡像內(nèi)置/health檢查見(jiàn) Dockerfile。備份數(shù)據(jù)卷直接打包# 把 webui 數(shù)據(jù)卷打包到當(dāng)前目錄 docker run --rm -v open-webui:/source -v $(pwd):/backup alpine tar -czf /backup/webui-backup.tar.gz -C /source .跑通之后下一步去看什么到這里你已經(jīng)有一個(gè)可離線使用的 AI 網(wǎng)頁(yè)服務(wù)。想再往下定制直接看這幾個(gè)文件主配置docker-compose.yaml鏡像構(gòu)建細(xì)節(jié)Dockerfile官方安裝說(shuō)明README.md常見(jiàn)問(wèn)題排查TROUBLESHOOTING.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），僅供參考