Open WebUI5 分钟跑起来的本地 AI 对话界面上手指南【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考