企业官网建设流程全解析

在家用机器上跑通 Open WebUI，全程只需 3 条命令

【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui

这是一篇写给"只会开浏览器"的读者的 Open WebUI 本地部署教程。Open WebUI 是一个可自托管、支持离线运行的 Web 版 AI 对话平台；你用 Docker（把程序和依赖打包成集装箱的工具）把它装到自己电脑上，数据和对话记录就只留在本地。读完照做，你能独立完成 Open WebUI Docker 部署，接上自己的第一个模型，并用它完成查文档、对比模型、文生图三件真事。

第一步：用 docker-compose 把 Open WebUI 跑起来

目标：在自己电脑上起一个本地 Web 服务，浏览器打开能看到登录页。

操作：先确认环境里有 Docker 和 Docker Compose（按 compose 文件一键拉起多个容器的工具）：

docker --version docker compose version

两条命令都输出版本号才算通过；缺哪个就装哪个，装完重跑验证。

然后克隆仓库并启动：

git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui

docker compose up -d

第一次运行会下载镜像，可能要几分钟，耐心等它把 open-webui 和 ollama 两个容器都拉起来。

怎么算成功：浏览器打开http://127.0.0.1:3000，看到登录 / 注册页面。注册一个账号，你是全站第一个用户，自动成为管理员。

第二步：接入你的第一个模型

目标：让聊天框能真正收到回复。模型来源二选一：Ollama 本地模型（免费离线、首次下载稍慢），或任意 OpenAI 兼容 API（需 API key、响应快）。

操作（Ollama 路线，推荐新手）：compose 文件已带一个 Ollama 容器，只需拉一个小模型：

ollama pull llama3.2

回到网页，顶部模型选择器出现llama3.2，选中它发一句话。

操作（OpenAI 兼容 API 路线）：在docker-compose.yaml的open-webui段环境变量里加两行，再重建容器：

docker compose up -d docker compose ps

怎么算成功：任选一路，给模型发"用一句话介绍你自己"，几秒内收到回复且页面无报错。

第三步：用 Open WebUI 完成三件真实任务

任务一：拿自己的一份 PDF 提问（内置 RAG）

1. 左侧栏 Knowledge，把一份 PDF 拖进去，等待解析完成（状态变为 Ready）。
2. 新开聊天，问一个只在这份文档里才有的事实，例如某个具体条款或参数。
3. 成功判据：回答内容与文档一致，且回复下方出现指向该文档的引用。答得"对"但没有引用，说明它用的是通用知识而非你的文档。

任务二：两个模型同屏对比回答

1. 同时接一个本地模型和一个 API 模型（见第二步，两种方式不互斥）。
2. 开两个聊天标签，分别选中两个模型，发同一个开放问题。
3. 成功判据：两条回答风格、长度、侧重明显不同。

任务三：文生图出一张图

1. 接一个支持图像生成的模型，在顶部选择它。
2. 输入提示词"油画风格的乡间小屋与田野"。
3. 成功判据：回复区直接出现图片，而不是一段文字描述。

第四步：按需进阶配置（换端口、换数据库、多用户）

只在你遇到对应场景时才改，改完都执行docker compose up -d使配置生效。

怎么算成功：改完访问新地址仍能看到登录页；docker compose ps中各容器状态为 running。

验收：照着清单勾一遍

• http://127.0.0.1:3000打开能看到登录页，并能注册管理员
• 第一个模型发话有回复，无 Connection Error
• 上传的 PDF 能被 Knowledge 检索到，回答带文档引用
• 两个模型对同一问题给出了不同风格的回答
• 重启容器后，聊天记录和知识库仍在（数据都在 Docker 卷里）

下一步：去 docs/official.md 查你想深入的配置项；想动手写工具插件时，代码骨架都在 plugins/ai/ 里。

【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui