Open WebUI部署：私有AI对话平台一步到位指南

Open WebUI部署：私有AI对话平台一步到位指南

【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui

连接本地 Ollama 或任意 OpenAI 兼容 API，浏览器里就能得到一个带用户管理、权限和知识库的对话界面——这就是 Open WebUI 部署能带给你的东西。无论你是个人居家办公，还是小团队想统一收口 AI 入口，它都是一个自托管 WebUI，一条 Docker 命令即可完成安装。

30秒速查

项目定位

一句话定义：Open WebUI 是一个自托管的大模型对话管理平台，把聊天、模型接入、账号权限、文档问答收进同一个后台。适合个人开发者和需要统一管理 AI 入口、又不想把数据交给第三方云的小型团队。

从"装完直接拿到什么"的角度看，它的核心能力有四块：

• 🧩模型聚合：Ollama、OpenAI 兼容接口统一挂载，模型列表在后台一处管理
• 👥多用户与权限：注册、分组、访问控制开箱即用，不是单机玩具
• 📄文档问答（RAG）：上传资料即可检索提问，内置加载与向量检索管线
• 🔌插件化扩展：工具、管道、函数均可按模块追加，不动主流程

前置检查

先看资源底线，再按部署方式备工具。

依赖工具按路径分组：

• 容器路径：Docker Engine + Compose（Docker Desktop 已含）
• 源码路径：Python 3.11–3.12（pyproject.toml要求>=3.11, <3.13）、Node.js 18.13–22.x、Git
• GPU 加速：nvidia-container-toolkit，再走 GPU 版 compose 文件

部署主流程

按目标选一条路径即可，每条路径末尾附确认方法。

容器路径：两条命令拉起服务

适合不想碰源码、只想快速用起来的人，3 步完成。

git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui && docker compose up -d

要 GPU 推理改用docker compose -f docker-compose.gpu.yaml up -d；完全不用 Ollama、只接云端 API 时，可换docker-compose.api.yaml。compose 文件里已写好两个关键映射：3000:8080端口和OLLAMA_BASE_URL=http://ollama:11434。

确认跑起来的标准：浏览器打开http://localhost:3000出现首次管理员注册页；docker compose ps中 ollama 与 open-webui 两个容器均为 running；docker logs -f open-webui无红色报错。

源码路径：可改代码的启动方式

适合要二次开发、定制前端或构建自有镜像的人，4 步完成。

cd open-webui pip install -r backend/requirements.txt npm install && npm run build cd backend && python -m uvicorn open_webui.main:app --port 8080

开发调试时可用仓库自带的backend/dev.sh，它带--reload热重载。注意源码直连监听 8080，与容器的 3000 映射口不同。

确认标准：curl http://localhost:8080/health返回正常，且浏览器访问 8080 能进入注册页。

生产形态：上线前三件事

仓库未附带 K8s manifest，上生产建议先把三件事定下来：固定WEBUI_SECRET_KEY（不固定时容器重建会导致会话全部失效）、用ENABLE_SIGNUP=False关闭公开注册、前面加反向代理终结 TLS。确认方式同容器路径。

配置要点

接入本地推理（Ollama）

1. 先保证ollama serve在跑（容器路径下 compose 已拉起）。
2. 源码部署则设置OLLAMA_BASE_URL=http://localhost:11434；容器部署该值已内置。
3. 进入界面设置 → 模型管理，拉取一次模型列表。
4. 列表出现可用模型即接入完成。

接入云端 API

1. 后台设置 → 模型管理 → OpenAI API区域，填入密钥与 Base URL；任何 OpenAI 兼容服务都能填。
2. 或者走环境变量：OPENAI_API_KEY配密钥，OPENAI_API_BASE_URLS配地址，多地址用分号分隔。
3. 选一个模型发一句对话，收到回复即打通。

安全基线

生产环境必做三项：WEBUI_SECRET_KEY设成随机长串并持久化；ENABLE_SIGNUP=False收口注册；给 API Key 做端点范围限制，缩小令牌可触达的接口面。三件进阶事各一句话带过：数据备份就是对backend/data下的 SQLite 库做sqlite3 ... .dump；自定义主题用WEBUI_CUSTOM_CSS_URL指向一份 CSS；功能插件放进插件目录后在设置里启用。

故障排查

更多细节见 TROUBLESHOOTING.md 与 docs/SECURITY.md。

适用场景与命令速查

Open WebUI 的甜区很清晰：个人或小团队的私有对话入口、本地 Ollama 推理网关、多用户共用云端 API 的管理层，数据始终落在自己机器上。深入细节从 README.md 起步，安全问题查 docs/SECURITY.md。

命令速查

【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui