GPT中文GPT中文论坛社区AI工具软件大全 GPT.CC Claude Fable 5 · GPT-5.6 直连,不用连国际网 去看看 →
AI工具软件大全
首页 / 文章 / OpenWebUI 快速上手教程(GitHub README 中文整理)
📖 教程 · 6 分钟读完 · 2026-07-24

OpenWebUI 快速上手教程(GitHub README 中文整理)

从 OpenWebUI 官方 GitHub README 翻译整理的快速上手指南。

是什么

Open WebUI 是一个可扩展、功能丰富、用户友好的自托管 AI 平台,专为完全离线运行而设计。它支持多种大语言模型(LLM)运行环境,如 Ollama 和兼容 OpenAI 接口的 API,并内置了 RAG(检索增强生成)推理引擎,是一套强大的 AI 部署方案。

项目主页:https://github.com/open-webui/open-webui


能干什么

Open WebUI 把 AI 能力打包成一个完整的 Web 应用,你可以用它来:


怎么装

方式一: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

启动后访问 http://localhost:3000

如需使用 Ollama 本地模型,请使用 :ollama 标签的镜像。

方式二:pip 安装

pip install open-webui
open-webui serve

方式三:Kubernetes

支持 kubectlkustomize 和 Helm 部署,详见官方文档。


怎么用第一个例子

  1. 启动服务:按上述任意方式安装并启动后,浏览器打开 http://localhost:3000
  2. 注册管理员账号:首次访问会引导你创建第一个用户,该用户自动成为管理员。
  3. 连接模型
    • 如果本地运行了 Ollama,Open WebUI 会自动发现模型。
    • 也可以进入设置页面,添加 OpenAI 兼容的 API 地址(如 LMStudio、GroqCloud 等)。
  4. 开始对话:在聊天框输入问题,选择模型,按回车即可。
  5. 上传文档做 RAG:点击聊天框旁的文档图标,上传 PDF、TXT 等文件,AI 会自动读取内容并基于文档回答。

社区资源


翻译整理自 GitHub README,原文:https://github.com/open-webui/open-webui

01

本文涉及的工具

02

相关阅读