Open WebUI：5 分钟跑起来的本地 AI 对话界面上手指南

Open WebUI：5 分钟跑起来的本地 AI 对话界面上手指南

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

Open WebUI 是一个自托管的大语言模型 Web 前端，兼容 Ollama、OpenAI API 等模型后端。它解决的是"本地有模型、却没有好用的界面来对话"的问题：跑一条 Docker Compose 命令，就能在浏览器里得到一个支持多用户、多频道、历史管理的对话平台。读完这篇文章，你大概 5 分钟内可以完成安装并发出第一条消息。

🎯 它解决什么场景

前面说清了项目定位，这一节看它实际用在哪些地方。

图：Open WebUI 主界面，左侧是频道与对话列表，中间可直接选择模型开始对话

三类典型用法：

• 本地模型没有界面：你已经在用 Ollama 但只能敲命令交互，Open WebUI 提供网页端对话，compose 文件里还捆绑了 ollama 容器，一起拉起来即可。
• 多个模型入口要统一管理：以前每接一个 OpenAI 兼容 API 就要换一个工具，现在在同一个界面里添加多条 Connection，顶部下拉就能切换模型。
• 小团队共享对话：以前靠截图和聊天记录转发，现在打开同一个实例，用频道（Channels）和文件夹（Folders）各管各的话题。

🚀 从 0 到第一次跑起来

前面几个场景都建立在"先跑起来"之上，安装方式只给最主流的一种：Docker Compose。

最快安装步骤：一条命令拉起来

先克隆代码，再启动容器：

git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui docker-compose up -d

三条命令分别负责获取代码、进入目录、启动 open-webui 和 ollama 两个容器。首次运行会构建镜像，稍慢属正常。注意 docker-compose.yaml 里端口映射是${OPEN_WEBUI_PORT-3000}:8080，对外默认端口是 3000，不是容器内部的 8080。

验证是否成功：浏览器里应该看到什么

打开 http://localhost:3000 。看到注册/登录表单，说明部署成功。注册第一个账号即为管理员，登录后界面左侧应出现 New Chat、Search、Notes、Channels 等入口，中间显示当前模型名。如果模型列表为空，先给 Ollama 拉一个模型，例如在宿主机执行ollama pull llama3.2，回到设置里刷新连接，模型就会出现。

💬 核心功能上手

装好之后，真实使用顺序是"连模型 → 发起对话 → 调设置"。

先连模型。点右上角头像进入设置里的 Connections，分 Ollama 和 OpenAI 两类：本地 Ollama 有默认连接，点一下 Connect 即可；接 OpenAI 兼容 API 则填写 base URL 和密钥，保存后模型自动进入列表。

再发起对话。中间输入框键入问题回车，顶部下拉可切换模型；输入框左侧的 + 号可以附加本地文件，让模型基于文件内容回答。

最后是个性化。设置页可以换主题、设默认模型、调温度等参数；相关默认值集中在后端 config.py 中定义。想按主题整理对话，就在侧边栏建文件夹；团队讨论则用频道，成员各自的消息互不干扰。

⚠️ 进阶与避坑

日常使用中最常踩的几个问题，按"现象 → 处理"来记：

• 页面打不开、端口冲突：3000 被占用时，用环境变量换端口启动，或改 docker-compose.yaml 的 ports 字段；不要直接动容器内的 8080。
• 模型列表为空：界面和 Ollama 已连通但模型没下载，先执行ollama pull拉模型再刷新连接；接远程 API 时先确认 base URL 没有多余或缺失的斜杠。
• 数据备份：账号、对话、文件都存在 open-webui 卷（容器内路径 /app/backend/data），迁移或备份时整卷复制即可。

升级版本时，固定套路是git pull后执行docker-compose down，再用docker-compose up -d --build重新构建，顺序不要颠倒。

🏁 最后

到这里，你手上已经有一个跑通的本地 AI 对话平台：本地模型和 API 模型都能接，对话可整理，多人可共享。后续遇到配置项看不懂，先看项目 docs 目录下的文档和根目录的 TROUBLESHOOTING.md。下一步可以试试换默认模型、建一个新文件夹，和它连续聊上五轮。

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