Open WebUI：本地大模型的友好聊天界面

为什么需要 Open WebUI？

当你用 Ollama 在本地跑起大模型后，往往只能用命令行交互，或者手动写脚本调用 API。这种体验既不直观，也不便于分享给团队使用。如果要搭建一个多人可用的聊天服务，还得自己处理前端、权限、会话保存等问题，工程量不小。Open WebUI 恰好填补了这个空白，它提供了类似 ChatGPT 的图形界面，让你开箱即用地管理本地模型，甚至能对接 OpenAI 兼容的云端 API。

核心功能：不止是一个聊天框

1. 直观的会话管理

Open WebUI 支持多会话保存，你可以随时创建新对话、切换历史会话，并对会话内容进行搜索。每条回复都会保留完整的 Markdown 渲染，代码块、表格、数学公式都能正确显示，极大提升阅读体验。同时，它也支持流式输出，文字逐字出现，反馈更即时。

2. 模型中心与统一接入

在 Open WebUI 中，你可以直接查看 Ollama 拉取到的所有模型，一键切换对话所用的模型，还能上传自定义模型文件。更贴心的是，它兼容 OpenAI API 格式，因此只要提供 API 地址和密钥，就可以把云端模型（如 GPT、Claude 等）接入同一个界面，统一管理本地与远程模型。

3. 多用户与知识库

Open WebUI 内置了轻量级用户系统，首次启动时注册的账号自动成为管理员，之后可以创建多个普通用户，并分配不同的角色权限。它甚至支持将文档（如 PDF、TXT）上传到内置的知识库中，让模型基于这些文档进行问答，实现 RAG（检索增强生成）功能，而无需额外配置向量数据库。

安装与使用：两种方式快速上手

方式一：Docker 安装（推荐）

确保你的电脑已安装 Docker，并已经启动 Ollama（默认监听 11434 端口）。然后执行以下命令：

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 运行在远程机器上，需要将 host.docker.internal 替换为实际 IP，并设置环境变量 OLLAMA_BASE_URL。

方式二：Python 包安装

如果你不想用 Docker，可以直接用 pip 安装：

pip install open-webui
open-webui serve

需要注意，Python 版本需≥3.11，Node.js≥20.9，且系统需安装 git 和 curl。运行后同样通过 http://localhost:3000 访问，默认端口为 8080，可通过 --port 参数修改。

注意事项

• 首次运行时，Open WebUI 会自动创建管理员账号，请在初始化后立即修改密码，并注意服务暴露在公网时的安全风险。
• 所有数据（用户、会话、配置）默认存放在 /app/backend/data 目录，建议定期备份该目录。
• 如果使用 GPU 加速，Open WebUI 无需额外配置，但 Ollama 需要正确安装 CUDA 或 ROCm 驱动。
• 该项目的许可证为 BSD-3-Clause，允许自由使用和商用，但需在衍生作品中保留版权声明和免责条款。