AI工具箱
Open WebUI

Open WebUI 使用教程

从入门到精通的完整指南

Open WebUI 简介

Open WebUI是一款功能丰富的开源自托管AI聊天界面,支持Ollama、OpenAI兼容API等多种LLM后端。它提供直观的Web界面,支持多模型切换、对话管理、RAG文档检索、Web搜索集成以及用户权限管理。部署简单,支持Docker一键安装,适合个人和团队搭建私有AI对话平台,无需依赖第三方云服务即可享受类ChatGPT体验。

详细功能介绍

【工具简介】Open WebUI是一款开源的自托管AI聊天Web界面,为多种大语言模型后端提供统一的交互入口。

【核心功能】①多模型支持:兼容Ollama、OpenAI API、以及各类OpenAI兼容接口,可在同一界面切换不同模型进行对话。②RAG文档检索:内置文档上传与检索增强生成功能,支持PDF、文本等格式,让AI基于你的私有文档回答问题。③Web搜索集成:支持联网搜索,使模型能够获取实时信息并结合网络内容生成回答。④用户与权限管理:内置完整的用户注册、登录系统,支持多用户协作,管理员可分配角色和权限。⑤对话管理与分享:支持对话历史保存、标签分类、导出以及公开分享链接。

【适用场景】个人或团队搭建私有AI助手平台,避免数据外泄;企业内部知识库问答系统,结合RAG功能检索内部文档;开发者测试和对比不同LLM模型的效果与性能。

【快速入门】①确保系统已安装Docker和Docker Compose。②克隆项目仓库并运行docker compose up -d启动服务。③在浏览器中访问默认端口完成初始管理员注册。④在设置中配置Ollama或OpenAI API密钥,即可开始对话。

【优缺点分析】优点:部署简单,Docker一键启动;界面美观且功能丰富,接近ChatGPT体验;活跃的开源社区,更新频繁。缺点:高级功能如RAG需要额外配置向量数据库;大量并发用户时对服务器资源要求较高;部分功能文档不够完善。

【适合人群】希望搭建私有AI对话平台的个人用户和技术爱好者;需要在企业内部署AI助手的IT管理员和运维团队;需要测试和评估多种LLM模型的AI开发者和研究人员。

1Open WebUI 入门教程:搭建私有 AI 对话平台

入门10分钟
Open WebUI 是一款功能丰富的开源自托管 AI 聊天界面,支持 Ollama、OpenAI 兼容 API 等多种 LLM 后端,提供多模型切换、RAG 文档检索、Web 搜索等强大功能,适合搭建私有 AI 对话平台。 快速开始 1. 确保已安装 Docker,执行命令拉取镜像:docker pull ghcr.io/open-webui/open-webui:main 2. 运行容器:docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main 3. 打开浏览器访问 http://localhost:3000,首次使用需要注册管理员账号,填写用户名和密码后即可进入主界面。 核心功能演示 功能一:多模型对话 在主界面左上角的模型选择器中,可以看到所有已接入的模型。点击切换不同模型进行对话,对比回答效果。你可以在同一对话中随时切换模型,也可以为不同模型创建独立对话。支持同时向多个模型发送同一问题,横向对比结果。 功能二:文档检索(RAG) 点击对话输入框旁的附件图标,上传 PDF、TXT、Markdown 等格式的文档。上传后文档会被自动索引,之后在对话中提问,AI 会结合文档内容回答。适合用来分析报告、查阅技术文档或让 AI 总结长篇文章的要点。 功能三:知识库管理 进入左侧栏的「知识库」功能,创建不同的知识集合并上传相关文档。在对话中引用特定知识库,AI 会优先从该知识库中检索信息。适合团队建立共享知识库,如产品文档、常见问题库等,提升回答的准确性和一致性。 实际使用案例 场景一:团队 AI 协作平台 在公司内网服务器部署 Open WebUI,团队成员通过统一入口使用 AI 对话。管理员配置好共享知识库,团队成员提问时 AI 能基于公司文档给出准确回答,避免信息孤岛,同时敏感数据不出内网。 场景二:个人学习助手 将学习资料上传到 Open WebUI 知识库,阅读论文时直接向 AI 提问,快速理解复杂概念。结合 Web 搜索功能,AI 还能补充最新的背景知识,打造个性化的智能学习环境。 常见问题 FAQ Q:如何接入自己的模型? A:在管理面板的「设置」中找到「连接」选项,添加 OpenAI 兼容 API 的地址和密钥即可。如果使用 Ollama,确保 Ollama 服务运行在同一网络中,Open WebUI 会自动发现可用模型。 Q:支持多少用户同时使用? A:Open WebUI 内置完善的用户管理系统,支持无限用户注册。性能取决于服务器配置和所用模型的推理能力,一般 4 核 8G 的服务器可支持 10-20 人日常使用。 Q:如何备份数据? A:所有数据存储在 Docker 挂载的 open-webui 卷中,备份时只需导出该卷:docker run --rm -v open-webui:/data -v /opt/ai-tools-nav:/backup alpine tar czf /backup/open-webui-backup.tar.gz /data,恢复时解压即可。 小贴士 1. 合理配置模型:不要一次性接入太多模型,根据团队实际需求选择 2-3 个主力模型即可,太多模型反而会让用户选择困难。 2. 善用系统提示词:在模型设置中自定义系统提示词,针对不同用途设定 AI 的角色和回答风格,比如代码助手、写作助手等,提升回答质量。 3. 定期清理对话:长时间使用后对话记录会占用存储空间,建议定期归档重要对话并清理过期记录,保持系统运行流畅。