一条命令部署 Open WebUI私有大模型界面安装与使用指南【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一个可自托管的大语言模型 Web 界面支持本地 Ollama 和 OpenAI 兼容 API 两类模型源让你的电脑变成一套完全离线运行的私有 AI 聊天服务。它适合想在自有机器上搭建 AI 应用的开发者也适合需要给不同成员分配不同能力的团队。三个前提、一条命令完成首次启动先安装 Docker各大 Linux 发行版和 macOS 都有官方安装脚本没有其他依赖。如果打算接本地 Ollama需要先单独安装 Ollama——它是真正负责跑模型的独立程序Open WebUI 只是界面。下面的命令会在后台启动 Open WebUI 容器并挂载一个用于存数据的数据卷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参数里值得留意三点-v open-webui:/app/backend/data挂载 Docker 数据卷聊天历史、用户、配置都存在这里这一行不能省否则重建容器就全丢了--add-hosthost.docker.internal:host-gateway让容器能发现宿主机的 Ollama--restart always异常退出时自动拉起启动成功的判断标准打开http://localhost:3000能看到注册页注册一个账号即可第一个注册的用户自动成为管理员也就是后台管理面板的入口。接入真实模型本地 Ollama 三步打通Open WebUI 本身不运行模型要能用得先给它一个模型源最省事的链路是本地 Ollama。第一步在宿主机拉一个模型8GB 内存的机器选 7B 足够ollama pull qwen2.5:7b第二步重启容器让它发现宿主机上的 Ollamadocker restart open-webui第三步打开网页顶部的模型下拉框。列表里出现 qwen2.5:7b、输入消息能收到回复链路就算通了。接入模型后的界面聊天区显示当前模型左侧是历史会话与频道入口如果模型列表是空的先确认宿主机上 Ollama 正在运行ollama list能看到模型。Ollama 在别的服务器上时启动容器加-e OLLAMA_BASE_URLhttps://你的服务器:11434即可。想用云端模型则更简单在后台的 OpenAI 设置里填 API 地址和密钥不需要额外的启动参数。上手后最常用的三个场景把 PDF 变成模型能引用的知识库在 Knowledge 区块上传文档系统自动切分并建立向量索引。聊天时用#命令引用知识库模型回答就会带文档出处而不是凭训练记忆硬答。这是 RAG检索增强生成的入口适合对产品文档、规范这类材料做问答。给团队分配不同的能力在 Admin 后台建用户并指派角色管理员能管模型和设置普通成员只能聊天临时协作者可以只给查看权限。Channels 是共享讨论空间人和模型在同一条时间线里发言可以 模型 让它总结或评审支持线程回复和消息反应适合沉淀团队讨论。让模型调工具而不只是说话在 Tools 区块安装插件或用 OpenAPI 规格接入自己的服务配置好后模型遇到需要查数据的任务会直接调用。配合#加 URL 的命令还能让它实时抓取网页内容。想自己写工具可以参考backend/open_webui/tools/目录下的内置实现。常见错误 30 秒排查部署后的大多数问题都能对下表定位现象常见原因解法页面打不开3000 端口被占用或被防火墙拦用ss -lntp看占用改成-p 3001:8080模型列表为空容器连不上 Ollama确认宿主机 Ollama 在跑仍连不上就改用--networkhost启动访问地址变为 8080聊天时报错模型没拉取或 Ollama 挂了ollama list确认模型在列表里重建容器后数据没了没挂数据卷重建时务必带上-v open-webui:/app/backend/data旧卷还在可用同名卷恢复排查思路按顺序来先看容器状态docker ps应显示 Up再docker logs --tail 50 open-webui错误原因多半直接写在日志里接着验证模型链路确认 Ollama 所在地址从容器内可达最后查数据卷docker volume inspect open-webui能确认卷是否已挂载。 重建容器前先确认旧数据卷里没有需要保留的数据再决定删除还是复用这一步没有回头路。下一步看什么想理解某个功能的实现从backend/open_webui/目录入手其中routers/子目录是 REST API 入口models/是数据定义改前端外观看src/lib/components/。完整的环境变量清单在仓库根目录的README.md里。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 一条命令部署 Open WebUI：私有大模型界面安装与使用指南
一条命令部署 Open WebUI私有大模型界面安装与使用指南【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webuiOpen WebUI 是一个可自托管的大语言模型 Web 界面支持本地 Ollama 和 OpenAI 兼容 API 两类模型源让你的电脑变成一套完全离线运行的私有 AI 聊天服务。它适合想在自有机器上搭建 AI 应用的开发者也适合需要给不同成员分配不同能力的团队。三个前提、一条命令完成首次启动先安装 Docker各大 Linux 发行版和 macOS 都有官方安装脚本没有其他依赖。如果打算接本地 Ollama需要先单独安装 Ollama——它是真正负责跑模型的独立程序Open WebUI 只是界面。下面的命令会在后台启动 Open WebUI 容器并挂载一个用于存数据的数据卷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参数里值得留意三点-v open-webui:/app/backend/data挂载 Docker 数据卷聊天历史、用户、配置都存在这里这一行不能省否则重建容器就全丢了--add-hosthost.docker.internal:host-gateway让容器能发现宿主机的 Ollama--restart always异常退出时自动拉起启动成功的判断标准打开http://localhost:3000能看到注册页注册一个账号即可第一个注册的用户自动成为管理员也就是后台管理面板的入口。接入真实模型本地 Ollama 三步打通Open WebUI 本身不运行模型要能用得先给它一个模型源最省事的链路是本地 Ollama。第一步在宿主机拉一个模型8GB 内存的机器选 7B 足够ollama pull qwen2.5:7b第二步重启容器让它发现宿主机上的 Ollamadocker restart open-webui第三步打开网页顶部的模型下拉框。列表里出现 qwen2.5:7b、输入消息能收到回复链路就算通了。接入模型后的界面聊天区显示当前模型左侧是历史会话与频道入口如果模型列表是空的先确认宿主机上 Ollama 正在运行ollama list能看到模型。Ollama 在别的服务器上时启动容器加-e OLLAMA_BASE_URLhttps://你的服务器:11434即可。想用云端模型则更简单在后台的 OpenAI 设置里填 API 地址和密钥不需要额外的启动参数。上手后最常用的三个场景把 PDF 变成模型能引用的知识库在 Knowledge 区块上传文档系统自动切分并建立向量索引。聊天时用#命令引用知识库模型回答就会带文档出处而不是凭训练记忆硬答。这是 RAG检索增强生成的入口适合对产品文档、规范这类材料做问答。给团队分配不同的能力在 Admin 后台建用户并指派角色管理员能管模型和设置普通成员只能聊天临时协作者可以只给查看权限。Channels 是共享讨论空间人和模型在同一条时间线里发言可以 模型 让它总结或评审支持线程回复和消息反应适合沉淀团队讨论。让模型调工具而不只是说话在 Tools 区块安装插件或用 OpenAPI 规格接入自己的服务配置好后模型遇到需要查数据的任务会直接调用。配合#加 URL 的命令还能让它实时抓取网页内容。想自己写工具可以参考backend/open_webui/tools/目录下的内置实现。常见错误 30 秒排查部署后的大多数问题都能对下表定位现象常见原因解法页面打不开3000 端口被占用或被防火墙拦用ss -lntp看占用改成-p 3001:8080模型列表为空容器连不上 Ollama确认宿主机 Ollama 在跑仍连不上就改用--networkhost启动访问地址变为 8080聊天时报错模型没拉取或 Ollama 挂了ollama list确认模型在列表里重建容器后数据没了没挂数据卷重建时务必带上-v open-webui:/app/backend/data旧卷还在可用同名卷恢复排查思路按顺序来先看容器状态docker ps应显示 Up再docker logs --tail 50 open-webui错误原因多半直接写在日志里接着验证模型链路确认 Ollama 所在地址从容器内可达最后查数据卷docker volume inspect open-webui能确认卷是否已挂载。 重建容器前先确认旧数据卷里没有需要保留的数据再决定删除还是复用这一步没有回头路。下一步看什么想理解某个功能的实现从backend/open_webui/目录入手其中routers/子目录是 REST API 入口models/是数据定义改前端外观看src/lib/components/。完整的环境变量清单在仓库根目录的README.md里。【免费下载链接】open-webuiUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)项目地址: https://gitcode.com/GitHub_Trending/op/open-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考