Open WebUI 完整部署指南：3 个阶段跑通你的私有 AI 界面

Open WebUI 完整部署指南3 个阶段跑通你的私有 AI 界面【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一个免费、自托管的 AI 平台给本地大模型套上一个开箱即用的 Web 界面。把它指向 Ollama 或任意 OpenAI 兼容 API你立刻拥有一个带文件上传、Markdown 渲染和用户权限管理的聊天页面。动手之前先选定部署路线任何命令都不用碰先定路线大多数机器只需要一条 Docker 命令不编译、不配环境。按硬件选路线路线安装方式适合谁标准 Docker官方:main镜像Ollama 在本机或另一台服务器上Docker GPU 加速:cuda镜像 --gpus all有 NVIDIA GPU 且装好 CUDA 工具链界面 Ollama 一体:ollama镜像想用一个容器同时跑界面和模型服务Python 原生pip install open-webui环境里装不了 Docker安装前检查三件事✅ 运行docker --version确认 Docker Engine 20.10 及以上 ✅ 计划用 GPU 的话nvidia-smi能打印驱动和 CUDA 版本 ✅ 3000 端口空闲。官方惯例是把容器内固定的 8080 端口映射到宿主机的 3000落地一条 Docker 命令装好容器版整个安装就是一条 Docker 命令跑完 3 分钟后你会在 http://localhost:3000 看到登录页。Ollama 在本机时的标准命令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其中--add-host让容器能找到宿主机上的 Ollama-v open-webui:/app/backend/data是数据卷卷名open-webui记牢以后升级和备份都靠它。Ollama 在别的服务器上就在上面那条命令里加-e OLLAMA_BASE_URLhttps://你的Ollama地址GPU 机器把镜像标签换成:cuda并加--gpus all。完全装不了 Docker 时退回 Python 路线pip install open-webui open-webui serve服务起在 8080 端口需要 Python 3.11。✅docker ps里 open-webui 容器状态为 Up ✅ 浏览器打开 http://localhost:3000出现注册/登录页跑起来之后连上模型再管好数据容器起来只是完成一半另一半是指向模型让它能对话并保证数据在重启后还在。把 Open WebUI 指向 Ollama默认它就去host.docker.internal:11434找 Ollama。用标准命令在本机启动、Ollama 也在本机时什么都不用改。登录后第一个账号自动成为管理员。先在 Ollama 里拉一个模型再到界面模型列表里刷新就能开聊。数据存在哪怎么备份聊天、用户、配置全在那个open-webui卷里后端默认用 SQLite。备份一条命令docker run --rm -v open-webui:/data -v $(pwd):/backup \ alpine tar -czf /backup/open-webui-$(date %F).tar.gz -C /data .✅docker restart open-webui后历史会话原样还在 ✅ 备份包有几百 KB 以上说明数据真的装进去了长期养几个环境变量和排错习惯长期运维不复杂就是几个该知道的环境变量加上两个绕不开的坑。值得记住的参数参数示例作用WEBUI_SECRET_KEY一串长随机值认证会话的密钥启用认证时必设OLLAMA_BASE_URLhttp://192.168.1.20:11434远程 Ollama 的地址HF_HUB_OFFLINE1离线模式不再尝试从 Hugging Face 拉模型改任何一项都是在启动命令里加-e 键值或者写进 docker-compose 文件。最常见的两个坑坑 1端口映射写错。 ❌-p 3000:3000容器内端口固定是 8080 ✅-p 3000:8080宿主机 3000 对容器 8080坑 2升级镜像时丢数据。 ❌ 拉了新镜像直接docker run起新容器却没挂同名卷 ✅ 始终保留-v open-webui:/app/backend/data起新容器前先停掉删掉旧容器连接出问题先访问健康端点 http://localhost:3000/health返回正常说明容器没毛病问题多半在 Ollama 那一侧。更多排查思路看官方 TROUBLESHOOTING.md环境变量的完整定义在 backend/open_webui/env.py业务逻辑都在 backend/open_webui/ 里。想自己构建镜像克隆仓库 https://gitcode.com/GitHub_Trending/op/open-webui 用根目录的 Dockerfile 打包即可。Open WebUI 是跑起来之后才会持续用到的项目模型、插件、知识库都可以慢慢往上加。把路线选对、数据管好剩下的就交给日常使用去回答了。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考