Open WebUI 完整部署指南5分钟跑起自己的AI聊天界面支持Ollama与OpenAI API【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一个自托管的 AI 聊天平台装在你自己的电脑或服务器上接上本地 Ollama 或任意 OpenAI 兼容 API 就能完全离线运行。如果你想要一个自己掌控数据的 AI 聊天界面——对话、知识库、记忆都不经过第三方——这个项目就是目前自托管 AI 聊天领域最完整的方案。下面聊聊从第一次开机到长期稳定运行的整条路径。第一次开机两条部署路径Docker 一行命令启动官方主推的路径是 Docker一条命令跑起来docker run -d -p 3000:8080 --add-hosthost.docker.internal:host-gateway \ -v open-webui:/app/backend/data --name open-webui --restart always \ ghcr.io/open-webui/open-webui:main几个关键参数值得多看一眼-p 3000:8080是宿主机端口映射容器内固定 8080宿主机可以换成你想要的任意端口--add-host让容器能自动找到宿主机的 Ollama-v open-webui:/app/backend/data是数据卷——这是官方文档自己标了警告的项漏掉它容器一删聊天记录全没了。不想装 Docker 的两行替代纯 Python 环境也能玩前提是装好 Python 3.11版本不对会各种报错pip install open-webui # 安装 open-webui serve # 启动后访问 http://localhost:8080按硬件选镜像标签你的情况推荐方式原因大多数通用场景:main镜像 Docker一条命令坑最少有 NVIDIA 显卡:cuda镜像加--gpus all硬件加速推理明显变快连 Ollama 都懒得单独装:ollama镜像Web 界面和模型运行器同容器真正开箱即用没有 Dockerpip 安装两行命令但依赖要自己维护启动完成后浏览器访问http://localhost:3000注册的第一个账号就是管理员记得保存好。两个验证信号docker ps里容器状态是 Up浏览器出现登录界面 ✅日常使用接上模型才能真正聊天三种模型连接方式界面跑起来只是一半模型还得接上——Open WebUI 是外壳本身不做推理。最常见的三种接法模型在哪连接方式注意本机 Ollama:main镜像默认配置自动经 host.docker.internal 发现零配置另一台机器的 Ollama启动时加-e OLLAMA_BASE_URLhttp://服务器:11434容器网络要能通到那台机器只用 API 不用 Ollama加-e OPENAI_API_KEY你的key任何 OpenAI 兼容服务都行vLLM、LMStudio、Groq 等换个 URL 就能混着用接好后在界面选择模型开聊。如果模型列表是空的八成是 Ollama 地址不通——先看容器日志再确认 Ollama 那边是否ollama pull过模型。 这里有个坑很多人第一次都会踩端口映射写成-p 3000:3000是错的冒号右边永远是容器端口 8080。第一条消息发不出去怎么办按顺序查三处容器日志docker logs open-webui里有没有连接报错Ollama 服务本身是否还在跑如果用的是远程地址容器网络是否真的能访问到。✅ 模型列表出现名字、发一条消息能收到回复就算接通了。不止聊天三个让它超出聊天框的功能知识库与持久记忆日常用几天你就会开始碰这两个功能把 PDF、网页文档丢进本地知识库聊天时用#引用回答就会带上你的文档内容——背后支持 9 种向量数据库还带混合检索和重排序。持久记忆则让模型跨对话记住关于你的事实昨天说过的偏好今天不用重复交代。多模型与协作特性同一个对话里塞多个模型回答同一个问题是横向对比模型质量的土办法但真的好用。往深了还有 Channels人和模型共处的共享时间线、Notes 笔记、日历排程和定时自动化插件系统可以在模型调用前后挂过滤器、动作和工具。功能面铺得很开基本每周都能挖到新东西。分享给团队一个实例多账号角色、组与文件夹共享想开放给同事时不用部署多个实例权限体系本来就是为多用户设计的管理端可以建组、逐项授权谁能管知识库、谁能分享、谁能动终端。0.10 版本起还能把整个聊天文件夹共享给指定用户或组对方在侧边栏就能看到默认只读。建议从默认权限按钮重置起步先收着给不够再加别一上来全开。企业登录接入公司有统一身份系统的话支持 LDAP/Active Directory、OAuth SSO 和 SCIM 自动开通账号不用自己维护一套账号。✅ 验证信号用一个新账号登录只能看到所属组被允许使用的模型和功能。长期运行持久化、备份与升级坑数据与备份所有对话、用户、配置都存在/app/backend/data这个数据卷里。只要-v后面的卷名保持不变别每次重建容器换个名字否则会得到一个全新的空实例数据就能跨越容器重启。备份就是把卷 tar 出来docker run --rm -v open-webui:/src -v $(pwd):/bak alpine tar -czf /bak/open-webui-backup.tar.gz -C /src .健康检查与升级后端内置/health接口定期 curl 一下就知道服务和数据库是否正常。升级是真正容易翻车的地方 0.10 系列涉及数据库结构变更官方明确要求升级前备份数据库多节点部署必须所有实例同时升级——滚动更新会直接导致故障。稳妥节奏是拉新镜像 → 备份 → 重建容器比追求全自动更新更省心。想先动手的话从:ollama镜像开始——一条命令把界面和模型跑全5 分钟验证完整链路再逐步碰知识库和权限设置。官方文档docs/后端源码目录backend/open_webui/界面前端源码src/lib/【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考