Open WebUI快速搭建完整指南：3步跑通你的离线AI对话平台

Open WebUI快速搭建完整指南3步跑通你的离线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 就能聊。它把聊天界面、模型管理、知识库、团队空间全放在一个本地服务里5 分钟就能在自己电脑上跑起来。先跑起来最快安装 Open WebUI 的两种方式如果你只是个人用pip 是最快的路就 2 条命令pip install open-webui open-webui serve然后浏览器打开http://localhost:8080注册第一个账号第一个账号自动是管理员界面就出来了。如果你习惯用 Docker一条命令搞定docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main注意-v open-webui:/app/backend/data这串别删它把数据库挂到了命名卷里删容器也不丢聊天记录。跑完访问http://localhost:3000即可。想要从源码开始先git clone https://gitcode.com/GitHub_Trending/op/open-webui拿到代码再参考 docs/ 里的安装文档即可。它到底能干什么不只是聊天气泡跑通之后把它当成一个AI 工作台而不是聊天框来用你会打开新世界。连上 Ollama 后侧边栏会直接列出你本地的所有模型点一个就能聊全程不需要联网。把 PDF、Word 甚至一整本电子书丢进知识库再在输入框里输入#号引用它AI 的回答就会基于你自己的文档而不是泛泛而谈。想让它查资料#后面跟一个网页地址它会把网页内容拉进对话。多人用的话可以开 Channels 频道把 AI 拉进同一个时间线里模型 让它参与讨论。它还带记忆功能聊过的偏好会带到下一个会话里不用每次重复自我介绍。用得顺手第一次使用的 4 个动线刚注册完别急着聊花 2 分钟走一遍下面几步后面体验完全不一样。第一步进设置把默认模型选好并确认 Ollama 的连接地址——模型列表为空时十有八九是地址没指对Docker 里访问宿主机一般要写host.docker.internal。所有可调参数都集中在 backend/open_webui/config.py改环境变量即可不用动代码。第二步熟悉两个高频快捷键入口#唤起知识库和网页引用指定某个模型回答。完整快捷键列表在 src/lib/shortcuts.ts顺手把发送换行调成你习惯的按键。第三步把常用提示词存成 Prompt 模板团队和模型管理则交给 src/lib/components/admin/ 对应的后台页面界面里点点就能配好。最后一步养成备份习惯整个平台的数据对话、知识库、账号都在本地 backend/open_webui/data/ 目录把这个目录复制一份你的所有 AI 资产就安全了。卡住了怎么破3 类常见启动问题排查端口 8080 被占用报错Address already in use时换掉映射端口就行比如 Docker 用-p 3000:8080pip 方式则设置WEBUI_PORT环境变量后重启。模型列表是空的先单独确认 Ollama 是否在跑ollama list再检查 Open WebUI 里的 Base URL 是否可达容器环境记得用host.docker.internal而不是localhost。启动直接报错pip 方式对版本敏感项目要求 Python 3.11用错版本会出现各种依赖报错换 3.11 重开虚拟环境通常就解决了。日志直接看终端输出更多情况可对照 TROUBLESHOOTING.md 逐项排查。数据想彻底重来停掉服务后清掉backend/data卷再启动即可。跑起来之后它就是你完全私有、随时可用的 AI 对话平台了。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考