Open WebUI Docker部署实战指南：从零到跑通 Ollama 网页界面的完整教程

Open WebUI Docker部署实战指南从零到跑通 Ollama 网页界面的完整教程【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui想在浏览器里跟大模型聊天又不想在本地装一堆依赖Open WebUI 是一个开源的 AI 网页界面直接对接 Ollama 和 OpenAI 兼容 API用 Docker Compose 一条命令就能把整套服务拉起来。这篇文章讲清楚从装到能用的完整流程。一张图看懂 Open WebUI Ollama 双容器架构说白了open-webui 负责界面ollama 负责跑模型两者在 Docker 内部网络里互相对话。数据存在两个命名卷里——卷就是 Docker 帮你在宿主机上管的一块存储容器删了数据还在。部署前先给机器做体检项目最低要求备注Docker Engine20.10需带 Compose v2内存4GB建议 8GB模型吃内存磁盘10GB 空闲装镜像和模型权重网络首次需要拉镜像和模型部署完可离线体检命令# 一次性检查 Docker 和 Compose 版本 docker --version docker compose version执行后你会看到两行Docker 版本号如27.x和Docker Compose version v2.x.x。缺哪个先补哪个。Open WebUI Docker 一键部署三步走第一步拿部署文件# 克隆仓库并进入目录 git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui执行后你会看到目录里躺着docker-compose.yaml它就是本次部署的主配置。第二步启动两个容器# 启动 ollama open-webui自动建内部网络和数据卷 docker compose up -d执行后你会看到两个容器的拉取/构建输出最后出现open-webui Started。首次要构建镜像耐心等几分钟。第三步确认跑起来了# 检查容器状态 docker compose ps执行后你会看到两条状态为running的容器。浏览器打开http://localhost:3000注册第一个账号它就是管理员。不想手敲 compose 文件的话仓库里还有个交互式脚本docker-compose-launcher.sh能自动探测 GPU、用参数选端口和数据目录。按需选装只挑你要的把入口换成 80 端口谁需要3000 端口被占或者想直接用域名 80/443 访问。# 临时用 80 端口启动只对本次生效 OPEN_WEBUI_PORT80 docker compose up -d想永久生效改 docker-compose.yaml 里OPEN_WEBUI_PORT-3000那一行。接外部 Ollama 实例谁需要Ollama 已经在别的服务器上跑着不想重复拉一个。# 指定外部 Ollama 地址覆盖 compose 里的默认值 OLLAMA_BASE_URLhttps://ollama.example.com docker compose up -d执行后你会在 compose 输出里看到OLLAMA_BASE_URL被覆盖为新地址。把 Ollama API 开放给外部工具谁需要想用脚本或其他程序直接调模型接口。# 叠加 api 配置额外暴露 11434 端口 docker compose -f docker-compose.yaml -f docker-compose.api.yaml up -d生产环境别把这个端口裸奔前面挂个反向代理加认证。开启 NVIDIA GPU 加速谁需要想跑大模型CPU 推理太慢。前提装了 NVIDIA 驱动和 Container Toolkit。# 叠加 gpu 配置给 ollama 容器分配 1 块 GPU docker compose -f docker-compose.yaml -f docker-compose.gpu.yaml up -d开启 AMD GPU谁需要显卡是 AMD 的。用 rocm 镜像 ROCm 驱动。# 叠加 amdgpu 配置换 :rocm 镜像并映射 GPU 设备 docker compose -f docker-compose.yaml -f docker-compose.amdgpu.yaml up -d指定数据存放位置谁需要想备份、迁移数据或者嫌命名卷看不见摸不着。# 把 ollama 数据改到宿主机目录 OLLAMA_DATA_DIR./ollama-data docker compose -f docker-compose.yaml -f docker-compose.data.yaml up -d执行后你会看到./ollama-data目录被创建模型权重直接躺在里面方便打包和迁移。 翻车急救包卡住了照这个查症状容器起不来反复重启排查一条docker compose logs --tail50 open-webui解法最常见是端口被占日志里会有port is already allocated换端口或杀掉旧进程提示权限错误就重建数据卷再启动。症状WebUI 提示找不到 Ollama排查一条docker compose exec ollama ollama list解法容器里列不出模型说明 WebUI 指错地址了。确认OLLAMA_BASE_URL在 compose 网络内应为http://ollama:11434别写成 127.0.0.1。症状模型跑得慢日志显示 CPU 推理排查一条docker run --rm --gpus all nvidia/cuda:12.1.1-base-ubuntu22.04 nvidia-smi解法没有输出就是 Docker 看不到 GPU重装 NVIDIA Container Toolkit 并重启 Docker 服务再用 gpu 配置启动。症状想确认服务健康、想备份数据排查一条docker inspect --format{{.State.Health.Status}} open-webui解法输出healthy即正常镜像内置/health检查见 Dockerfile。备份数据卷直接打包# 把 webui 数据卷打包到当前目录 docker run --rm -v open-webui:/source -v $(pwd):/backup alpine tar -czf /backup/webui-backup.tar.gz -C /source .跑通之后下一步去看什么到这里你已经有一个可离线使用的 AI 网页服务。想再往下定制直接看这几个文件主配置docker-compose.yaml镜像构建细节Dockerfile官方安装说明README.md常见问题排查TROUBLESHOOTING.md【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考