Open WebUI 快速上手：从 0 到 1 搭建本地 AI 对话平台
【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui
想和 AI 聊天，又怕对话内容流到别人的服务器上？Open WebUI 是一个自托管的本地 AI 对话平台，支持 Ollama 和 OpenAI 兼容 API，可以完全离线运行，装在自己的机器上就能用。
它属于本地 AI 的 WebUI 这一类工具，相当于给 Ollama 这类模型运行器套了一层图形化外壳——不用写 curl 调 API，也不用盯着终端敲命令。最突出的差异是"完全离线"：对话记录、上传的文件、知识库数据全部落在你自己的磁盘上，用户权限、插件、检索问答都是开箱自带，装完容器断网也能照常工作。
⚡ 五分钟跑起 Open WebUI 本地对话平台
最快的路径是用 Docker Compose，一条命令把 Ollama 服务界面一起拉起来：
git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui docker-compose up -d第一行克隆项目代码，第二行进入目录，第三行在后台启动两个容器：Ollama 模型服务和 Open WebUI 界面。完成后浏览器打开 http://localhost:3000 ，按页面提示注册一个账号——第一个注册的账号自动成为管理员，之后就可以开始接模型了。
🧩 接上第一个 Ollama 模型
你依次会做三件事：装模型、选模型、发第一条消息。
装模型：Ollama 容器本身不带模型，在宿主机终端执行ollama pull qwen2.5下载一个，首次拉取需要几分钟，耐心等一下。
选模型：下载完成后，点 Open WebUI 顶部输入框上方的模型下拉菜单，刚才装的模型会出现在列表里，点一下选中。
发消息：在输入框输入问题回车，模型开始逐字回复。你会看到左侧出现一条新对话，之后的每次聊天都会自动归档在这里，随时可以翻回去看。
📎 把文档喂给 AI 做检索问答
这是新手最容易上头的功能：让 AI 基于你自己的资料回答，而不是凭空编。
操作分两步：在左侧侧边栏找到知识库（Knowledge）入口，把 PDF、Word 或纯文本文件拖进去，等它处理完；然后回到对话页，点输入框左侧的附件图标，勾选刚才建好的知识库。
你会看到什么：提问后模型的回答会附上引用来源，答到文档里的内容时会直接标注出处。把公司手册、论文、合同喂进去，它就能变成"只答你资料里有的问题"的专属助手。
🎯 欢迎页先逛一圈再干活
刚打开的第一个界面就是欢迎页，除了居中插画，下面会挂着几张建议问题卡片，比如"帮我学习""给我看段代码"。
不用自己想提示词，随便点一张卡片就能直接生成一条对话，顺便熟悉一下界面布局：左侧管对话和知识库，中间管聊天，右上角齿轮进设置。
📐 新手容易忽略的效率加分项
- 快捷键：新建对话、打开设置、呼出快捷键面板都有默认键位，按 Cmd+/（Windows 上是 Ctrl+/）可以查看和自定义，绑定定义在 src/lib/shortcuts.ts。
- 数据卷：Docker 安装必须挂载
open-webui:/app/backend/data卷，否则容器一删数据全丢，默认配置里已经写好了，参考 docker-compose.yaml。 - 离线模式：完全断网的环境可以设置环境变量
HF_HUB_OFFLINE=1，阻止它尝试联网下载模型，相关逻辑见 backend/open_webui/env.py。 - 多模型对比：支持多模型对话，让几个模型同时回答同一个问题，谁答得好一目了然，适合挑主力模型。
#命令：在输入框输入#加一个网址，可以直接把网页拉进对话当上下文，不用先下载成文件。
⚠️ 踩坑速查：三个高频问题
浏览器提示无法连接 Ollama→ 容器访问不到宿主机 11434 端口 → 启动时改用--network=host网络模式，细节见 TROUBLESHOOTING.md。
重启后对话和账号全没了→ 启动时没挂数据卷 → 加上-v open-webui:/app/backend/data再跑。
3000 端口被占用→ Compose 默认把 8080 映射到 3000 → 启动前设置环境变量OPEN_WEBUI_PORT=3001换个端口即可。
📚 下一步
配置卡住就先翻仓库里的 TROUBLESHOOTING.md 排查，能跑通第一条对话后，去管理面板把知识库和插件配起来就是。
【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
