Open WebUI - 开源琅嬛阁

返回开源琅嬛阁

精选

open-webui/open-webui

User-friendly AI Interface (Supports Ollama, OpenAI API, ...)

👥 —

432

142,246

⑂ 20.4k

github.com · open-webui/open-webui

本地模型自托管AI 工具

官方主页 / 文档 在 GitHub 查看

项目介绍

Open WebUI 是一个功能丰富的自托管 AI Web 平台，常见搭配是 Ollama、本地推理服务或兼容 OpenAI API 的后端。它把对话、模型管理、RAG 知识库和多用户能力打包成可部署应用，适合希望在内网或家用服务器上运行 AI 助手的用户。

核心特性

• 响应式 Web 界面，支持桌面与移动端访问
• 原生对接 Ollama 与 OpenAI 兼容 API
• 内置 RAG 管道，可上传文档构建知识库
• 支持多模型切换、对话分支与角色预设
• Docker 一键部署，社区插件与主题生态活跃

对用户价值

它把模型调用、对话体验和常见管理能力包装成可部署的 Web 应用，用户不必从零编写聊天前端。对使用 Ollama 或私有 API 的个人与小团队，落地成本明显低于自建全套 UI 与鉴权系统。

与替代方案

• 相比 LobeHub 等多模型客户端，Open WebUI 更强调自托管与 RAG 一体化。
• 相比 ChatGPT 等云服务，数据与模型调用留在自己的基础设施内。
• 若只需极简 CLI 对话，Ollama 自带界面或终端工具可能更轻量。

适应人群

• 使用 Ollama 或 OpenAI 兼容 API 的个人用户。
• 需要私有 AI 助手入口的小团队。
• 想快速验证本地模型体验的自托管爱好者。

如何使用

前置条件

• 已安装 Docker，或具备 Python 运行环境。
• 后端模型服务可用（本机 Ollama 或远程兼容 API）。

安装方式

Ollama 在本机时，常用 Docker 命令：

docker run -d -p 3000:8080 \
  --add-host=host.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，按向导创建管理员账号并连接 Ollama 或 API 端点。

验证是否成功

发起一次对话并切换模型，确认回复正常；若启用 RAG，上传小文档测试检索是否生效。

常见坑 / 注意事项

• Docker 访问宿主机 Ollama 时需正确配置 host.docker.internal 或网络模式。
• 多用户场景务必配置认证与 HTTPS，避免内网裸奔。
• 定期备份 open-webui 数据卷，避免对话与知识库丢失。