Open WebUI 部署教程5分钟在本地跑起一个 AI 对话平台【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一个可自托管的 AI 对话界面支持连接 Ollama 本地模型和各种 OpenAI 兼容 API数据全部保存在自己的机器上。这篇教程面向刚接触本地 LLM 的用户按步骤完成 Open WebUI 的安装、模型连接和首次配置读完即可在浏览器里使用自己的 AI 助手。判断你是否适合用 Open WebUI适用场景你已经有或打算安装一个 Ollama 本地模型服务或者持有某个 OpenAI 兼容 API 的密钥想要一个不用写代码就能对话的界面。环境要求Docker 部署方式适合任何能跑容器的 Linux、macOS、Windows 环境pip 方式要求 Python 3.11避免兼容性问题。限制条件它本身不提供模型推理能力只是界面和调度层。没有模型源Ollama 服务或 API 密钥时装完只能看到空界面。完全离线环境也能运行但需要提前把模型下载到本机。从0到可运行最短部署路径推荐方式Docker Compose一条命令同时拉起 Ollama 和 Open WebUI省去单独配置模型服务的步骤。在终端中执行git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui docker compose up -d预期结果终端显示两个容器启动成功浏览器打开http://localhost:3000compose 文件将容器的 8080 端口映射到本机 3000 端口能看到账号创建页面。失败时看什么执行docker compose logs open-webui查看后端日志重点找端口占用和 Ollama 连接失败的报错。备选方式pip 本地安装适合不想用容器的机器。pip install open-webui open-webui serve预期结果服务监听本机 8080 端口访问http://localhost:8080即可。失败时查看终端输出的 uvicorn 日志通常是 Python 版本不是 3.11 或端口被占用。首次打开后必做的3件事1. 创建第一个账号入口首次访问时页面直接显示注册表单右上角为登录/注册入口。操作填写邮箱和密码完成注册。验证右上角出现用户头像进入带侧边栏的主界面。2. 连接一个可用的模型使用 Ollamacompose 文件已内置 Ollama 服务并设置OLLAMA_BASE_URLhttp://ollama:11434只需再拉取模型例如ollama pull llama3.1模型会出现在页面顶部的模型选择栏。使用 OpenAI 兼容 API启动容器时通过-e OPENAI_API_KEY你的密钥传入密钥如果 API 地址不是 OpenAI 官方地址对应的 base URL 环境变量名需查阅项目官方文档确认。验证顶部选择一个模型发送一条测试消息能收到回复即表示连接成功。也可以在 设置 General 里确认 Ollama Server URL 配置是否正确。3. 上传一份文档试用知识库入口侧边栏的工作区Workspace中的知识库管理页具体菜单位置可能随版本变化需查阅官方文档对应章节。操作新建知识库并上传一个 PDF 或文本文件等待解析完成。验证在对话中使用#命令引用库内内容回答能体现文档信息即说明检索增强RAG生效。让项目更好用的3个进阶动作用 Channels 建一个团队协作空间入口侧边栏 Channels 中的#general等频道。适合多人共用一个部署、希望围绕同一话题讨论的场景。在频道里 某个模型可以让它起草或评论内容支持话题线程、表情回应、置顶和访问控制。收益讨论、人和 AI 的回复在同一个时间线里不用来回切换聊天窗口。用 Notes 管理对话之外的内容入口侧边栏 Notes。适合写方案、整理资料等长篇任务。富文本编辑器支持 AI 改写选中文本并且可以把某条笔记附加到任意聊天上作为该聊天的上下文注入。收益沉淀下来的内容不必每次重新粘贴给模型。用 Automations 跑定时任务入口Automations 管理页。适合每天固定时间生成报告、做提醒的场景。设置周期性执行的提示词每次运行会显示在日历上并链接回它产生的那次聊天。收益不用手动触发执行记录可追溯。卡住时先看这里现象页面报 Server Connection Error连不上 Ollama检查点Docker 容器内的127.0.0.1:11434指向容器自身而非宿主机这是最常见的断连原因。 解决给容器加--networkhost注意此时访问地址变为http://localhost:8080或把OLLAMA_BASE_URL设为宿主机局域网地址如http://192.192.168.1.1:11434形式的实际网段地址然后在 设置 General 里核对 Ollama Server URL。现象长回复生成到一半超时中断检查点Open WebUI 对 Ollama 的默认超时是 5 分钟。 解决设置环境变量AIOHTTP_CLIENT_TIMEOUT单位为秒按模型实际生成速度调大。现象容器升级或重建后对话数据丢失检查点docker run时是否挂载了数据卷。 解决命令中必须包含-v open-webui:/app/backend/datacompose 部署已默认配置该挂载检查docker volume ls确认卷存在。现象浏览器打不开页面不确定端口检查点compose 部署映射为3000:8080应访问http://localhost:3000pip 本地启动固定是 8080。 解决若 3000 端口被占用修改 compose 文件中ports一侧的主机端口如3001:8080后重启。现象完全离线的机器上仍尝试联网下载模型检查点是否设置了离线开关。 解决设置环境变量HF_HUB_OFFLINE1阻止向 Hugging Face Hub 发起下载请求。继续深入backend/open_webui/config.py所有环境变量如OLLAMA_BASE_URL、端口、密钥都在这一个文件里定义改配置前先在这里确认变量名和默认值。TROUBLESHOOTING.md仓库自带的故障排查文档详细解释了后端如何通过/ollama路由反向代理 Ollama 请求、为什么要做这层代理以及各类连接错误的定位方法。docker-compose.yaml默认的 Ollama WebUI 联合部署配置修改镜像标签、端口映射、环境变量时直接改这个文件。模型接入、向量数据库选型、LDAP/SSO 等企业级配置不在本教程范围内遇到具体需求需查阅项目官方文档对应章节。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Open WebUI 部署教程：5分钟在本地跑起一个 AI 对话平台
Open WebUI 部署教程5分钟在本地跑起一个 AI 对话平台【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一个可自托管的 AI 对话界面支持连接 Ollama 本地模型和各种 OpenAI 兼容 API数据全部保存在自己的机器上。这篇教程面向刚接触本地 LLM 的用户按步骤完成 Open WebUI 的安装、模型连接和首次配置读完即可在浏览器里使用自己的 AI 助手。判断你是否适合用 Open WebUI适用场景你已经有或打算安装一个 Ollama 本地模型服务或者持有某个 OpenAI 兼容 API 的密钥想要一个不用写代码就能对话的界面。环境要求Docker 部署方式适合任何能跑容器的 Linux、macOS、Windows 环境pip 方式要求 Python 3.11避免兼容性问题。限制条件它本身不提供模型推理能力只是界面和调度层。没有模型源Ollama 服务或 API 密钥时装完只能看到空界面。完全离线环境也能运行但需要提前把模型下载到本机。从0到可运行最短部署路径推荐方式Docker Compose一条命令同时拉起 Ollama 和 Open WebUI省去单独配置模型服务的步骤。在终端中执行git clone https://gitcode.com/GitHub_Trending/op/open-webui cd open-webui docker compose up -d预期结果终端显示两个容器启动成功浏览器打开http://localhost:3000compose 文件将容器的 8080 端口映射到本机 3000 端口能看到账号创建页面。失败时看什么执行docker compose logs open-webui查看后端日志重点找端口占用和 Ollama 连接失败的报错。备选方式pip 本地安装适合不想用容器的机器。pip install open-webui open-webui serve预期结果服务监听本机 8080 端口访问http://localhost:8080即可。失败时查看终端输出的 uvicorn 日志通常是 Python 版本不是 3.11 或端口被占用。首次打开后必做的3件事1. 创建第一个账号入口首次访问时页面直接显示注册表单右上角为登录/注册入口。操作填写邮箱和密码完成注册。验证右上角出现用户头像进入带侧边栏的主界面。2. 连接一个可用的模型使用 Ollamacompose 文件已内置 Ollama 服务并设置OLLAMA_BASE_URLhttp://ollama:11434只需再拉取模型例如ollama pull llama3.1模型会出现在页面顶部的模型选择栏。使用 OpenAI 兼容 API启动容器时通过-e OPENAI_API_KEY你的密钥传入密钥如果 API 地址不是 OpenAI 官方地址对应的 base URL 环境变量名需查阅项目官方文档确认。验证顶部选择一个模型发送一条测试消息能收到回复即表示连接成功。也可以在 设置 General 里确认 Ollama Server URL 配置是否正确。3. 上传一份文档试用知识库入口侧边栏的工作区Workspace中的知识库管理页具体菜单位置可能随版本变化需查阅官方文档对应章节。操作新建知识库并上传一个 PDF 或文本文件等待解析完成。验证在对话中使用#命令引用库内内容回答能体现文档信息即说明检索增强RAG生效。让项目更好用的3个进阶动作用 Channels 建一个团队协作空间入口侧边栏 Channels 中的#general等频道。适合多人共用一个部署、希望围绕同一话题讨论的场景。在频道里 某个模型可以让它起草或评论内容支持话题线程、表情回应、置顶和访问控制。收益讨论、人和 AI 的回复在同一个时间线里不用来回切换聊天窗口。用 Notes 管理对话之外的内容入口侧边栏 Notes。适合写方案、整理资料等长篇任务。富文本编辑器支持 AI 改写选中文本并且可以把某条笔记附加到任意聊天上作为该聊天的上下文注入。收益沉淀下来的内容不必每次重新粘贴给模型。用 Automations 跑定时任务入口Automations 管理页。适合每天固定时间生成报告、做提醒的场景。设置周期性执行的提示词每次运行会显示在日历上并链接回它产生的那次聊天。收益不用手动触发执行记录可追溯。卡住时先看这里现象页面报 Server Connection Error连不上 Ollama检查点Docker 容器内的127.0.0.1:11434指向容器自身而非宿主机这是最常见的断连原因。 解决给容器加--networkhost注意此时访问地址变为http://localhost:8080或把OLLAMA_BASE_URL设为宿主机局域网地址如http://192.192.168.1.1:11434形式的实际网段地址然后在 设置 General 里核对 Ollama Server URL。现象长回复生成到一半超时中断检查点Open WebUI 对 Ollama 的默认超时是 5 分钟。 解决设置环境变量AIOHTTP_CLIENT_TIMEOUT单位为秒按模型实际生成速度调大。现象容器升级或重建后对话数据丢失检查点docker run时是否挂载了数据卷。 解决命令中必须包含-v open-webui:/app/backend/datacompose 部署已默认配置该挂载检查docker volume ls确认卷存在。现象浏览器打不开页面不确定端口检查点compose 部署映射为3000:8080应访问http://localhost:3000pip 本地启动固定是 8080。 解决若 3000 端口被占用修改 compose 文件中ports一侧的主机端口如3001:8080后重启。现象完全离线的机器上仍尝试联网下载模型检查点是否设置了离线开关。 解决设置环境变量HF_HUB_OFFLINE1阻止向 Hugging Face Hub 发起下载请求。继续深入backend/open_webui/config.py所有环境变量如OLLAMA_BASE_URL、端口、密钥都在这一个文件里定义改配置前先在这里确认变量名和默认值。TROUBLESHOOTING.md仓库自带的故障排查文档详细解释了后端如何通过/ollama路由反向代理 Ollama 请求、为什么要做这层代理以及各类连接错误的定位方法。docker-compose.yaml默认的 Ollama WebUI 联合部署配置修改镜像标签、端口映射、环境变量时直接改这个文件。模型接入、向量数据库选型、LDAP/SSO 等企业级配置不在本教程范围内遇到具体需求需查阅项目官方文档对应章节。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考