10分钟跑通一个私有AI聊天界面Open WebUI 部署实操【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui模型厂商自带的 Demo 页面很简陋想给团队一个能登录、能传文档、能切换模型的正式聊天入口时往往找不到顺手的工具。Open WebUI 就是干这个的一个自托管的 AI 聊天界面WebUI接本地 Ollama 或任意 OpenAI 兼容接口从零到可登录界面约 10 分钟不需要运维经验。它是什么谁该读这篇一句话定位大模型服务的前台。模型本体在别处本机 Ollama 或某个 APIOpen WebUI 负责登录、会话管理、文档上传问答RAG即先检索你上传的资料再回答、多用户权限。该继续读你手里已有模型服务Ollama 或 OpenAI 兼容 API想给个人或团队一个可用的网页聊天入口。可以跳过只想用 Python 脚本直接调 API或要的是 SaaS 产品。三条路线按需求挑路线做法适合谁耗时A. docker compose 一键Ollama 和 WebUI 都进容器不碰代码绝大多数人推荐约 10 分钟B. 源码手动前后端分别本地运行可改代码要改界面/调逻辑的开发者30 分钟起C. pip 包安装把后端当 Python 包装上就跑没有 Docker 的机器约 20 分钟只看你选中的那一节即可。A 下面写细B、C 给要点。路线 A容器一键从 clone 到可登录环境要求核对完就可以动手项要求系统Windows 10/11、macOS 12、Linux 均可软件Docker 与 Docker ComposeDocker Desktop 自带硬件双核 4GB 内存即可Web 部分不吃 GPU⚠️ 提示容器里的 Ollama 只在你本地拉模型时才下载权重之后纯 CPU 就能跑。① 获取代码git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui完成后进入项目根目录能看到 docker-compose.yaml 等文件。② 启动容器docker compose up -d 首次运行会拉两个镜像open-webui 与 ollama合计数 GB等输出停止滚动。完成后docker compose ps应显示两个服务均为 Up。⚠️ 提示卡在拉镜像就检查 Docker 镜像源配置端口 3000 被占用就在根目录建.env文件加一行OPEN_WEBUI_PORT新端口再重新docker compose up -d。③ 打开页面浏览器访问 http://localhost:3000首次进入让你填管理员账号——先填的人即管理员后续可在管理面板里给其他人开户。路线 B、C 要点B源码手动Python 3.11 或 3.12不支持 3.13Node 18.13~22。后端cd backend pip install -r requirements.txt然后执行./backend/dev.sh带热重载的 uvicorn监听 8080前端根目录npm install后npm run dev页面起在 localhost:5173预期现象两个终端各打出启动成功5173 页面与 8080 接口互通dev.sh 已配好 CORS。卡住先查node -v是否在区间内8080 终端的 Python traceback。Cpip 包pipx install open-webui open-webui start前端静态资源随包发布启动后直接访问 8080 端口。首跑自检过一遍这 5 项✓ 访问地址打开后出现登录/注册页✓ 填完管理员账号进入聊天界面侧边栏可见会话列表✓ 模型页面列出 Ollama 或 API 提供的模型✓ 发一句打个招呼能收到回复首次生成偏慢属正常✓ 上传一个 txt/pdf 并提问回答引用了文档内容任一项失败先拉日志docker compose logs -f open-webui手动部署则看跑 uvicorn 的那个终端。接上你的模型三个场景场景一本地 Ollama默认已通docker-compose.yaml 里已写好OLLAMA_BASE_URLhttp://ollama:11434无需改动只需在宿主机拉一个模型ollama pull qwen2.5:7bOllama 在别的机器上时把该地址改成对应 IP:11434 即可。场景二云端 APIOpenAI 兼容页面右上角管理面板→模型配置新增一个 OpenAI 类型连接Base URL 填https://api.openai.com/v1或任一兼容服务地址Key 填your-api-key。保存后该服务的模型出现在列表里发消息时按模型选择即可。 ⚠️ 提示Key 对管理员可见团队共用环境不要贴进公开项目里。场景三自带资料知识库入口新建知识库拖入 pdf/docx/txt选一个嵌入模型embedding把文字转成可检索向量的模型完成索引。聊天时勾选引用该知识库回答就会基于你的文档。生产环境必踩的 3 个坑密钥WEBUI_SECRET_KEY留空时首次启动会随机生成并落盘见 backend/start.sh 第 32 行附近。密钥一变所有登录态作废。生产环境请在.env显式固定WEBUI_SECRET_KEY随机长字符串。数据账号、会话、上传文件全在open-webui数据卷挂载于/app/backend/data。定期备份这个目录docker compose cp open-webui:/app/backend/data ./webui-backup-日期恢复就是把目录写回同位置。 3.注册开关ENABLE_SIGNUP默认 True意味着任何人可自助注册。内部服务在.env加ENABLE_SIGNUPfalse账号只由管理员发放更多开关含义见 backend/open_webui/config.py。卡住了高频问题速查症状原因解法3000 端口拒绝连接服务没起来或崩溃docker compose psdocker compose logs open-webui能登录但模型列表为空容器连不到 Ollama核对 OLLAMA_BASE_URL宿主机ollama ps确认在运行镜像一直拉不下来网络问题配置 Docker 镜像源后重试升级后报数据库错误迁移未跑完docker compose down再up -d深挖看 TROUBLESHOOTING.md模型生成一会儿就超时默认超时 5 分钟设环境变量AIOHTTP_CLIENT_TIMEOUT秒数上传文档问答无引用知识库没选嵌入模型知识库设置里补选 embedding 模型跑起来之后到这里你有了一个能登录、接模型、查资料的 AI 聊天界面。三件建议马上做的事接一个云端 API 作为本地模型的备份上传几份真实工作文档建第一个知识库团队使用先把注册关掉再开账号。更多部署组合GPU、Postgres 等看根目录其余 docker-compose.*.yaml 文件遇到怪问题先去项目 Issues 搜同款报错大概率有人替你踩过。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 10分钟跑通一个私有AI聊天界面：Open WebUI 部署实操
10分钟跑通一个私有AI聊天界面Open WebUI 部署实操【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui模型厂商自带的 Demo 页面很简陋想给团队一个能登录、能传文档、能切换模型的正式聊天入口时往往找不到顺手的工具。Open WebUI 就是干这个的一个自托管的 AI 聊天界面WebUI接本地 Ollama 或任意 OpenAI 兼容接口从零到可登录界面约 10 分钟不需要运维经验。它是什么谁该读这篇一句话定位大模型服务的前台。模型本体在别处本机 Ollama 或某个 APIOpen WebUI 负责登录、会话管理、文档上传问答RAG即先检索你上传的资料再回答、多用户权限。该继续读你手里已有模型服务Ollama 或 OpenAI 兼容 API想给个人或团队一个可用的网页聊天入口。可以跳过只想用 Python 脚本直接调 API或要的是 SaaS 产品。三条路线按需求挑路线做法适合谁耗时A. docker compose 一键Ollama 和 WebUI 都进容器不碰代码绝大多数人推荐约 10 分钟B. 源码手动前后端分别本地运行可改代码要改界面/调逻辑的开发者30 分钟起C. pip 包安装把后端当 Python 包装上就跑没有 Docker 的机器约 20 分钟只看你选中的那一节即可。A 下面写细B、C 给要点。路线 A容器一键从 clone 到可登录环境要求核对完就可以动手项要求系统Windows 10/11、macOS 12、Linux 均可软件Docker 与 Docker ComposeDocker Desktop 自带硬件双核 4GB 内存即可Web 部分不吃 GPU⚠️ 提示容器里的 Ollama 只在你本地拉模型时才下载权重之后纯 CPU 就能跑。① 获取代码git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui完成后进入项目根目录能看到 docker-compose.yaml 等文件。② 启动容器docker compose up -d 首次运行会拉两个镜像open-webui 与 ollama合计数 GB等输出停止滚动。完成后docker compose ps应显示两个服务均为 Up。⚠️ 提示卡在拉镜像就检查 Docker 镜像源配置端口 3000 被占用就在根目录建.env文件加一行OPEN_WEBUI_PORT新端口再重新docker compose up -d。③ 打开页面浏览器访问 http://localhost:3000首次进入让你填管理员账号——先填的人即管理员后续可在管理面板里给其他人开户。路线 B、C 要点B源码手动Python 3.11 或 3.12不支持 3.13Node 18.13~22。后端cd backend pip install -r requirements.txt然后执行./backend/dev.sh带热重载的 uvicorn监听 8080前端根目录npm install后npm run dev页面起在 localhost:5173预期现象两个终端各打出启动成功5173 页面与 8080 接口互通dev.sh 已配好 CORS。卡住先查node -v是否在区间内8080 终端的 Python traceback。Cpip 包pipx install open-webui open-webui start前端静态资源随包发布启动后直接访问 8080 端口。首跑自检过一遍这 5 项✓ 访问地址打开后出现登录/注册页✓ 填完管理员账号进入聊天界面侧边栏可见会话列表✓ 模型页面列出 Ollama 或 API 提供的模型✓ 发一句打个招呼能收到回复首次生成偏慢属正常✓ 上传一个 txt/pdf 并提问回答引用了文档内容任一项失败先拉日志docker compose logs -f open-webui手动部署则看跑 uvicorn 的那个终端。接上你的模型三个场景场景一本地 Ollama默认已通docker-compose.yaml 里已写好OLLAMA_BASE_URLhttp://ollama:11434无需改动只需在宿主机拉一个模型ollama pull qwen2.5:7bOllama 在别的机器上时把该地址改成对应 IP:11434 即可。场景二云端 APIOpenAI 兼容页面右上角管理面板→模型配置新增一个 OpenAI 类型连接Base URL 填https://api.openai.com/v1或任一兼容服务地址Key 填your-api-key。保存后该服务的模型出现在列表里发消息时按模型选择即可。 ⚠️ 提示Key 对管理员可见团队共用环境不要贴进公开项目里。场景三自带资料知识库入口新建知识库拖入 pdf/docx/txt选一个嵌入模型embedding把文字转成可检索向量的模型完成索引。聊天时勾选引用该知识库回答就会基于你的文档。生产环境必踩的 3 个坑密钥WEBUI_SECRET_KEY留空时首次启动会随机生成并落盘见 backend/start.sh 第 32 行附近。密钥一变所有登录态作废。生产环境请在.env显式固定WEBUI_SECRET_KEY随机长字符串。数据账号、会话、上传文件全在open-webui数据卷挂载于/app/backend/data。定期备份这个目录docker compose cp open-webui:/app/backend/data ./webui-backup-日期恢复就是把目录写回同位置。 3.注册开关ENABLE_SIGNUP默认 True意味着任何人可自助注册。内部服务在.env加ENABLE_SIGNUPfalse账号只由管理员发放更多开关含义见 backend/open_webui/config.py。卡住了高频问题速查症状原因解法3000 端口拒绝连接服务没起来或崩溃docker compose psdocker compose logs open-webui能登录但模型列表为空容器连不到 Ollama核对 OLLAMA_BASE_URL宿主机ollama ps确认在运行镜像一直拉不下来网络问题配置 Docker 镜像源后重试升级后报数据库错误迁移未跑完docker compose down再up -d深挖看 TROUBLESHOOTING.md模型生成一会儿就超时默认超时 5 分钟设环境变量AIOHTTP_CLIENT_TIMEOUT秒数上传文档问答无引用知识库没选嵌入模型知识库设置里补选 embedding 模型跑起来之后到这里你有了一个能登录、接模型、查资料的 AI 聊天界面。三件建议马上做的事接一个云端 API 作为本地模型的备份上传几份真实工作文档建第一个知识库团队使用先把注册关掉再开账号。更多部署组合GPU、Postgres 等看根目录其余 docker-compose.*.yaml 文件遇到怪问题先去项目 Issues 搜同款报错大概率有人替你踩过。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考