三步部署 Open WebUI接入 Ollama 的私有 AI 聊天界面【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一款面向本地大模型与 OpenAI 兼容 API 的开源 Web 聊天界面。它把账号登录、会话管理、模型切换、知识检索这些功能都做好了你不需要自己写前端。如果你已经用 Ollama 在本地跑模型或者手里有 API 接口想给团队共用它可以直接作为入口使用。适合谁能换来什么先说清楚边界避免装完发现不符预期你有一台闲置机器或笔记本想把它变成全家/全组可访问的 AI 助手你用 Ollama 跑本地模型但嫌命令行交互不方便你有 OpenAI 等 API 的 Key想要一个带用户体系、能多人区分的 Web 前端你不打算改代码只想开箱即用。如果你需要深度二次开发前端那直接看源码更合适本文只覆盖跑起来。启动后你会得到什么部署完成后浏览器打开http://localhost:3000首次访问会引导你创建第一个账号该账号自动成为管理员。登录后在设置里指向 Ollama 或 OpenAI 兼容端点就能在左侧管理会话和文件夹、在顶部切换模型、在 Workspaces 里按场景分组对话。数据账号、会话、上传文件默认存放在 Docker 命名卷里重启容器不丢。最短前置条件动手前确认三件事系统装有 Docker推荐或 Python 3.8 与 Node.js手动路径才需要可用内存至少 2GB端口 3000 未被占用你确定模型服务已经能独立跑通本机 Ollama 或远程 API否则后面只会卡在连不上模型这一步。推荐路径Docker Compose 一步起服务仓库里的 docker-compose.yaml 已经配好两个容器ollama本地模型和open-webuiWeb 服务端口映射为3000:8080并用host.docker.internal指向宿主机上的 Ollama。git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui docker compose up -d首次执行要拉取并构建镜像耐心等待几分钟。只想跑 UI、模型放在别处时可以只启动open-webui服务并在环境变量里把OLLAMA_BASE_URL改成实际的模型服务地址。备选路径从源码手动安装没有 Docker 时按下面顺序操作前后端分开构建cd backend pip install -r requirements.txtcd src npm install npm run buildcd backend python -m uvicorn open_webui.main:app --host 0.0.0.0 --port 8080注意此时服务监听 8080不是 3000。日常开发调试可以改用 backend/dev.sh它带热重载。首次启动检查清单依次验证以下四点全部通过才算部署成功访问http://localhost:3000能看到登录/注册页注册第一个账号确认可登录且角色为管理员进入设置确认 Ollama 服务地址可达模型列表出现至少一个模型发起一次真实对话流式输出正常、停止生成按钮可用。若第 3 步失败优先看下一节的排查顺序。连不上模型或打不开页面的排查按出现频率从高到低处理页面打不开确认 3000 端口没被别的进程占用必要时用OPEN_WEBUI_PORT换端口界面正常但模型列表为空容器内访问不到 Ollama。检查OLLAMA_BASE_URL是否正确跨机器部署时填目标机器 IP 而非localhost容器起不来时可用--networkhost方式运行访问地址随之变为http://localhost:8080生成长回复中途断掉默认 5 分钟超时可用环境变量AIOHTTP_CLIENT_TIMEOUT秒调大想看细节docker logs open-webui看容器日志架构与路由机制说明见 TROUBLESHOOTING.md。原理上前端请求会先到 WebUI 后端再由后端按OLLAMA_BASE_URL转发给 Ollama所以前端能打开、模型连不上几乎都是这个转发地址的问题。部署完之后往哪走管理员面板在路由/admin下可管账号、群组与全局设置API 能力都在 backend/routers/ 下聊天、文件、知识库等模块可基于它做二次集成界面多语言文件位于src/lib/i18n/locales/中文默认可用有 NVIDIA 显卡时参考仓库根目录的docker-compose.gpu.yaml配置 GPU 加速的 Ollama。部署本身到此结束剩下的时间应该花在挑模型和整理知识库上而不是折腾环境。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 三步部署 Open WebUI：接入 Ollama 的私有 AI 聊天界面
三步部署 Open WebUI接入 Ollama 的私有 AI 聊天界面【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一款面向本地大模型与 OpenAI 兼容 API 的开源 Web 聊天界面。它把账号登录、会话管理、模型切换、知识检索这些功能都做好了你不需要自己写前端。如果你已经用 Ollama 在本地跑模型或者手里有 API 接口想给团队共用它可以直接作为入口使用。适合谁能换来什么先说清楚边界避免装完发现不符预期你有一台闲置机器或笔记本想把它变成全家/全组可访问的 AI 助手你用 Ollama 跑本地模型但嫌命令行交互不方便你有 OpenAI 等 API 的 Key想要一个带用户体系、能多人区分的 Web 前端你不打算改代码只想开箱即用。如果你需要深度二次开发前端那直接看源码更合适本文只覆盖跑起来。启动后你会得到什么部署完成后浏览器打开http://localhost:3000首次访问会引导你创建第一个账号该账号自动成为管理员。登录后在设置里指向 Ollama 或 OpenAI 兼容端点就能在左侧管理会话和文件夹、在顶部切换模型、在 Workspaces 里按场景分组对话。数据账号、会话、上传文件默认存放在 Docker 命名卷里重启容器不丢。最短前置条件动手前确认三件事系统装有 Docker推荐或 Python 3.8 与 Node.js手动路径才需要可用内存至少 2GB端口 3000 未被占用你确定模型服务已经能独立跑通本机 Ollama 或远程 API否则后面只会卡在连不上模型这一步。推荐路径Docker Compose 一步起服务仓库里的 docker-compose.yaml 已经配好两个容器ollama本地模型和open-webuiWeb 服务端口映射为3000:8080并用host.docker.internal指向宿主机上的 Ollama。git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui docker compose up -d首次执行要拉取并构建镜像耐心等待几分钟。只想跑 UI、模型放在别处时可以只启动open-webui服务并在环境变量里把OLLAMA_BASE_URL改成实际的模型服务地址。备选路径从源码手动安装没有 Docker 时按下面顺序操作前后端分开构建cd backend pip install -r requirements.txtcd src npm install npm run buildcd backend python -m uvicorn open_webui.main:app --host 0.0.0.0 --port 8080注意此时服务监听 8080不是 3000。日常开发调试可以改用 backend/dev.sh它带热重载。首次启动检查清单依次验证以下四点全部通过才算部署成功访问http://localhost:3000能看到登录/注册页注册第一个账号确认可登录且角色为管理员进入设置确认 Ollama 服务地址可达模型列表出现至少一个模型发起一次真实对话流式输出正常、停止生成按钮可用。若第 3 步失败优先看下一节的排查顺序。连不上模型或打不开页面的排查按出现频率从高到低处理页面打不开确认 3000 端口没被别的进程占用必要时用OPEN_WEBUI_PORT换端口界面正常但模型列表为空容器内访问不到 Ollama。检查OLLAMA_BASE_URL是否正确跨机器部署时填目标机器 IP 而非localhost容器起不来时可用--networkhost方式运行访问地址随之变为http://localhost:8080生成长回复中途断掉默认 5 分钟超时可用环境变量AIOHTTP_CLIENT_TIMEOUT秒调大想看细节docker logs open-webui看容器日志架构与路由机制说明见 TROUBLESHOOTING.md。原理上前端请求会先到 WebUI 后端再由后端按OLLAMA_BASE_URL转发给 Ollama所以前端能打开、模型连不上几乎都是这个转发地址的问题。部署完之后往哪走管理员面板在路由/admin下可管账号、群组与全局设置API 能力都在 backend/routers/ 下聊天、文件、知识库等模块可基于它做二次集成界面多语言文件位于src/lib/i18n/locales/中文默认可用有 NVIDIA 显卡时参考仓库根目录的docker-compose.gpu.yaml配置 GPU 加速的 Ollama。部署本身到此结束剩下的时间应该花在挑模型和整理知识库上而不是折腾环境。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考