Open WebUI 快速上手：从 0 到 1 搭建本地 AI 对话平台

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_OFFLINE1阻止它尝试联网下载模型相关逻辑见 backend/open_webui/env.py。多模型对比支持多模型对话让几个模型同时回答同一个问题谁答得好一目了然适合挑主力模型。#命令在输入框输入#加一个网址可以直接把网页拉进对话当上下文不用先下载成文件。⚠️ 踩坑速查三个高频问题浏览器提示无法连接 Ollama→ 容器访问不到宿主机 11434 端口 → 启动时改用--networkhost网络模式细节见 TROUBLESHOOTING.md。重启后对话和账号全没了→ 启动时没挂数据卷 → 加上-v open-webui:/app/backend/data再跑。3000 端口被占用→ Compose 默认把 8080 映射到 3000 → 启动前设置环境变量OPEN_WEBUI_PORT3001换个端口即可。 下一步配置卡住就先翻仓库里的 TROUBLESHOOTING.md 排查能跑通第一条对话后去管理面板把知识库和插件配起来就是。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考