本教程将带你全面了解 Open WebUI——一款专为大模型设计、可私有化部署的开源可视化交互工具。通过简洁明了的步骤,你将学会如何安装、配置并运用其强大功能,轻松实现大模型的调试、管理与调用,获得类似 ChatGPT 的流畅体验。
简介
Open WebUI 是一款专为大模型设计的开源可视化交互工具,它通过类 ChatGPT 的直观界面,让用户无需代码即可管理、调试和调用本地或云端的大语言模型(LLMs)。
特点:可扩展、功能丰富、自托管、可完全离线运行

核心功能
Ollama/OpenAI API 集成: 轻松集成兼容 OpenAI 的 API,实现与 Ollama 模型的灵活对话。自定义 OpenAI API URL,即可与 LMStudio、GroqCloud、Mistral、OpenRouter 等平台连接。
完全支持 Markdown 和 LaTeX: 通过全面的 Markdown 和 LaTeX 功能提升 LLM 体验,实现丰富的交互,例如在聊天中直接渲染数学公式和格式化文本。
免提语音/视频通话: 体验集成的免提语音和视频通话功能的无缝通信,从而实现更加动态和互动的聊天环境。
本地 RAG 集成: 借助突破性的检索增强生成 (RAG) 支持,探索聊天交互的未来。此功能将文档交互无缝集成到聊天体验中。你可以直接在聊天中加载文档,或将文件添加到文档库,并在查询前使用命令轻松访问它们。
网页浏览功能: 使用命令后跟 URL,即可将网站无缝集成到聊天体验中。此功能允许你将网页内容直接融入对话中,增强互动的丰富性和深度。
图像生成集成: 使用 AUTOMATIC1111 API 或 ComfyUI(本地)以及 OpenAI 的 DALL-E(外部)等选项无缝整合图像生成功能,通过动态视觉内容丰富聊天体验。
多模型对话: 轻松同时与各种模型互动,利用其独特优势获得最佳响应。同时利用多种模型,提升你的体验。
安装部署
Open WebUI 可以使用 Python 软件包安装程序 pip 进行安装。环境需要 Python 3.11,以避免出现兼容性问题。
1. 安装 Open WebUI: 打开终端并运行以下命令来安装 Open WebUI:
pip install open-webui
2. 运行 Open WebUI: 安装后,可以通过执行以下命令启动 Open WebUI:
open-webui serve
这将启动 Open WebUI 服务器,你可以通过 http://localhost:8080 访问它。

小提示: 如果安装过程中遇到依赖冲突,建议使用 Python 虚拟环境(如 venv 或 conda)来隔离项目。另外,若需要更改端口,可在启动命令后添加 --port 参数,例如 open-webui serve --port 9090。
界面截图




常见问题
- Q:安装后运行
open-webui serve提示“command not found”怎么办?
A:这通常是因为 pip 安装的脚本未加入系统 PATH。请检查是否在虚拟环境中安装,或使用python -m open_webui启动(注意下划线)。也可以重新运行pip install open-webui并确保安装成功。 - Q:如何集成 Ollama 模型?
A:启动 Open WebUI 后,在设置页面中找到“连接”或“API”选项,填写 Ollama 的 API 地址(默认http://localhost:11434)即可。确保 Ollama 服务已运行且模型已下载。 - Q:为什么我无法通过
http://localhost:8080访问?
A:请检查终端中是否显示服务已启动,并确认端口 8080 未被其他程序占用。如果防火墙阻止,可尝试关闭防火墙或添加规则。另外,确保使用的是 Python 3.11 环境。
通过以上步骤,你已经成功部署并掌握了 Open WebUI 的核心使用方法。现在,尽情享受私有化 AI 交互平台带来的高效与便捷吧!
