OpenWebUI 使用教程：从入门到上手

什么是 OpenWebUI

OpenWebUI 是一个开源的 Web 客户端，专门用来对接本地部署的大语言模型。简单说，它就是一个浏览器里能直接用的 AI 聊天界面，后端可以连接 Ollama 或者 OpenAI 的 API。项目由美国团队 OpenWebUI 开发，完全免费，代码托管在 GitHub 上。

它的核心价值在于：你不需要自己写前端代码，也不需要折腾复杂的配置，装好就能得到一个功能完整的聊天 UI，支持多用户、对话管理、插件扩展等企业级特性。对于已经部署了 Ollama 的用户来说，OpenWebUI 几乎是默认的 Web 界面选择。

核心功能怎么用

默认对接 Ollama：安装完成后，OpenWebUI 会自动扫描同机或局域网内的 Ollama 服务，把已经下载的模型全部列在界面上。你直接在聊天框里选模型、打字，就能开始对话，和用 ChatGPT 的体验几乎一样。

多用户支持：首次访问会要求创建管理员账号。之后你可以添加普通用户，每个人有独立的对话历史、设置和文件上传权限。适合团队内部使用，避免互相干扰。

对话管理：左侧边栏会列出所有历史对话，支持搜索、重命名、删除。你可以随时回到之前的对话继续聊，上下文不会丢失。

文件上传与 RAG：支持上传 PDF、TXT、Markdown 等格式文件，模型会自动读取内容作为上下文。这相当于一个简易的 RAG（检索增强生成）功能，不需要额外配置向量数据库。

插件系统：内置了一些实用插件，比如网页内容抓取、代码执行沙箱、图片生成（需要对接 Stable Diffusion 等）。在聊天时输入 / 就能调出插件列表。

第一次上手步骤

1. 准备环境：确保你已经安装了 Docker（推荐）或 Python 3.11+。如果要用 Ollama 后端，先装好 Ollama 并拉取一个模型，比如 ollama pull llama3。

2. 安装 OpenWebUI：最省事的方式是用 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
   

   这条命令会把服务跑在 3000 端口，数据持久化在本地卷里。

3. 首次访问：打开浏览器访问 http://localhost:3000，会看到注册页面。第一个注册的账号自动成为管理员。

4. 连接模型：如果 Ollama 在同一台机器上，OpenWebUI 会自动发现它。如果 Ollama 在其他机器，进入设置 -> 连接，把 Ollama 的 URL 改成 http://你的OllamaIP:11434。

5. 开始聊天：注册登录后，左侧模型列表里应该能看到你之前拉取的模型。选一个，在输入框打字发送即可。如果模型没出现，检查 Ollama 是否在运行，以及网络是否可达。

适合什么场景

企业内部部署：多用户隔离、管理员权限、对话历史留存，这些特性让 OpenWebUI 很适合公司内部搭建 AI 助手。你可以把它部署在内网服务器上，员工通过浏览器访问，不需要每个人都装 Ollama 和模型。

个人开发者：如果你在本地跑 Ollama 做实验，OpenWebUI 比命令行交互舒服太多。它还能帮你管理多个模型，切换对比效果。

教育或研究：给实验室或课程搭建一个共享的 LLM 环境，学生通过 Web 界面使用，老师可以统一管理模型和用户。

注意：如果你打算用 OpenAI 的 API 作为后端，OpenWebUI 也支持，但 OpenAI 官方服务在国内访问受限，可以考虑使用国产替代 API（如国内大模型厂商提供的兼容接口）。

价格说明

OpenWebUI 本身完全免费，没有隐藏收费，没有订阅制，没有功能限制。你只需要承担运行它的基础设施成本：

• 如果你用 Docker 跑在自己的电脑上，成本就是电费和硬件折旧。
• 如果部署到云服务器，需要支付云厂商的服务器费用。
• 模型推理成本取决于你用的后端——Ollama 用本地 GPU 不花钱，OpenAI API 按 token 计费。

总之，OpenWebUI 是零软件成本，你只需要为硬件和算力买单。