Open WebUI

Open WebUI 是什么？

Open WebUI 是一个自托管 AI 平台：一个基于浏览器的聊天工作区，可安装在笔记本电脑、服务器或集群上，再连接到你选择的模型。它设计为可完全离线运行，支持 Ollama 和 OpenAI 兼容 API，因此一个界面就能同时服务本地模型和云端托管模型。

Open WebUI 自称“自托管 AI 界面”，是一个按你自己的方式运行 AI 的平台。Open WebUI 本身没有模型，每次对话都运行在管理员所连接的服务商或本地运行时上。该项目的网站（包括其社区中心）归 Open WebUI, Inc. 所有。

按 2026 年 10 月 5 日的抓取，主页显示 406M+ 次下载、506K+ 名社区成员和 154K+ 个 GitHub 星标；这些是厂商公布的计数器，并非经过审计的使用数据。

许可是首先要核查的事项。2025 年 4 月发布 v0.6.6 时，项目保留了宽松许可的基础，但新增了品牌保护条款，这决定了谁可以给界面换品牌、谁需要付费许可证。

核心功能

Open WebUI 在一次部署中整合了聊天、检索、插件和用户管理。某个实例具体能做什么，取决于管理员连接了哪些模型服务商、搜索引擎和存储。

模型与聊天

• 自选服务商：在同一界面中与 Ollama、OpenAI、Anthropic 或任何 OpenAI 兼容服务商聊天，并可在聊天中附加文件、搜索网络、执行代码或让模型调用工具。
• 并排回答：多模型聊天会并排运行两个模型，方便比较它们对同一提示词的回答。
• 以协议为核心：核心围绕 OpenAI Chat Completions API 等标准协议构建，而非各厂商的专有 API。

知识与检索

• 知识库：可上传文件、构建知识库，并在面向大型资料集的向量搜索（RAG）与精度比规模更重要时使用的全文注入之间选择。
• 向量存储：ChromaDB 和 PGVector 是官方维护的向量数据库，Qdrant、Milvus、Elasticsearch 等则属于非核心集成。

插件、MCP 与智能体

• Python 与 API：Python 工具在聊天中运行，外部服务通过 OpenAPI 或 MCP 接入，管道（pipelines）可过滤、转换或路由每条消息。
• MCP 支持：使用 Streamable HTTP 传输的 MCP 服务器可原生连接；其他 MCP 传输方式需经由官方的 MCPO 代理适配器。
• Open Terminal：智能体可获得真实的终端和文件系统，用来分析数据、运行脚本、修复自身错误，并交回所生成的文件，全部在聊天中完成。

团队与管理

• 默认多用户：管理员可定义角色、创建用户组、按模型设置访问权限，并连接身份提供商。
• 目录集成：登录可以绑定现有的 LDAP、Active Directory 和 SSO 提供商。
• 频道：持久的共享空间让人和 AI 模型参与同一场对话。
• 评估：管理端包含模型竞技场、A/B 测试和基于 ELO 的排行榜。

因为 Open WebUI 位于用户和模型之间，本地大模型界面和云端网关其实是同一个产品的不同配置。所选端点决定推理在哪里发生：云端模型会收到提示词及其中包含的上下文，多模型比较则把提示词发往每个所选端点。

使用指南

用 Docker 安装并连接模型

1. 运行快速入门中的 Docker 命令，并设置一次 WEBUI_SECRET_KEY；若无固定密钥，每次重建容器都会让所有人退出登录。
2. 打开界面：Docker 在 3000 端口提供服务，Python 安装和桌面应用使用 8080 端口，首次启动需要一分钟左右。
3. 创建第一个账户，它将成为管理用户和所有实例级设置的管理员。
4. 在 Settings > Admin > Connections（设置 > 管理员 > 连接）中添加模型，同一台机器上的 Ollama 实例会被自动识别。OpenAI、Anthropic 或其他 OpenAI 兼容服务商的 API 密钥填写在 Manage OpenAI API Connections（管理 OpenAI API 连接）中。
5. 开启 New Sign Ups（新用户注册）来邀请同事，因为管理员存在后注册即关闭，新账户随后以 Pending（待审核）状态等待，直到管理员批准。

Python 安装方式是依次运行 pip install open-webui 和 open-webui serve。开始使用无需在厂商处注册账户。另有无需登录的单用户模式，但以此模式启动的实例之后无法切换为多账户模式。

Open WebUI 使用场景与示例

• 离线与物理隔离环境中的助手：Open WebUI 面向物理隔离网络、远程部署以及其他难以使用云系统的场景设计，包括在无网络条件下运行 LLM，或离线运行本地 AI 聊天机器人。
• 全校范围的 AI 入口：在厂商企业页面的一则客户评价中，Johannes Gutenberg University Mainz 的一位 AI 架构师表示，Open WebUI 是一套自托管技术栈的聊天前端，服务 30,000+ 名学生和 5,000+ 名员工。
• 全公司定制助手：另一则厂商发布的案例称，安斯泰来制药让 3,000+ 名员工在 Azure 上创建并共享了 420+ 个定制 AI 模型，其中 68% 表示效率显著提升。
• 岗位专属助手：团队可以构建遵循内部风格指南的“Python 辅导老师”，或使用公司模板的“会议纪要助手”，因为每个定制模型都把一个基础模型与绑定的知识、工具和系统提示词封装在一起。

这些客户成果均为厂商托管页面上的自述，未经独立测量。

适用人群

Open WebUI 适合准备好自行运行和维护服务的人。

• 家庭实验室与个人用户：已在运行 Ollama 的人可在同一台机器上加装聊天界面；Docker 是官方支持的方式，也推荐大多数用户使用。
• 受监管行业的 IT 团队：其自托管、本地部署和物理隔离选项被宣传为在 SOC 2、HIPAA 或 GDPR 等框架内运营的基础，但合规责任由部署的组织承担。
• 拥有私有网络的组织：Open WebUI 为私有、可信的网络而构建，就像数据库或 CI 服务器一样，大多数部署运行在防火墙、VPN 或类似的网络边界之后。

以下情况则不太适合：

• 寻求商业许可的个人：企业许可证只面向已注册的实体和组织，不面向个人用户。
• 想要托管服务的团队：Open WebUI 是需要你自行安装和管理的软件，所核查的企业页面和产品页面均未列出厂商托管方案。

支持平台

• 操作系统：Open WebUI 可在 x86_64 或 ARM64 架构的 macOS、Windows 和 Linux 上运行，包括 Raspberry Pi 和 NVIDIA DGX Spark。
• 安装方式：除了 Docker 和 pip，Kubernetes 是面向需要扩展和编排的企业部署的方式。
• Python 版本：pip 包支持 Python 3.11 和 3.12，暂不支持 Python 3.13。
• 镜像大小：如果模型通过托管 API、自有模型服务器或独立的 Ollama 实例运行，slim 标签可将下载量从 1.66 GB 减至 176 MB。
• slim 的取舍：使用 slim 镜像时，知识搜索和语音功能需要外部服务。
• Docker 中的 GPU：只有 Docker for Windows 和 Linux 上的 Docker Engine 官方支持 GPU；Linux 版和 macOS 版 Docker Desktop 不提供。
• 扩展：应用层是无状态的，因此多个副本共享数据库和存储，由 Redis 协调会话和实时事件，需求增长时可在负载均衡器后增加更多副本。
• 手机与平板：每个实例都是渐进式 Web 应用（PWA），可直接从浏览器安装到手机、平板或桌面设备。
• 通知：回复完成和频道消息的浏览器通知只在应用打开时触发，因为没有推送服务。
• iPhone 与 iPad：在 iOS 上只有 Safari 能安装它，因为那里的 Chrome 和 Firefox 无法添加 PWA。
• 桌面应用：桌面应用无需 Docker 或手动配置即可原生运行 Open WebUI，不过生产部署被引导使用 Docker 或 Python 方式。

价格套餐

你现在无需签订企业协议就能部署 Open WebUI，厂商表示，正是企业客户和个人赞助者让它可以按现状免费使用。表中提到的企业层 Terminals 会为每个用户提供带资源限制和自动生命周期管理的隔离环境。

一旦涉及品牌，免费路径就会变化。品牌要求只适用于累计 50+ 名用户的较大规模部署，用户数为 50 名或更少的自托管内部部署可以完全换品牌。为大规模再分发或转售而移除品牌，需要企业许可证或专有许可证。

可选的企业许可证会增加白标和面向企业的专属支持等权益。所核查的企业页面上未出现标价；销售团队会要求提供正式工作邮箱和预计的最终用户席位数。

Open WebUI Computer 是一个独立的 Open WebUI 项目，有自己的定价。它即使在工作中使用也免费，无需账户或银行卡；Supporter 方案为每个席位每年 $60，提供额外权益；企业条款则为定制。

Open WebUI 替代品

有两个替代品覆盖了人们拿来与 Open WebUI 权衡的主要方向：一个多服务商 Web 平台，以及一个桌面优先的私人助手。

• LibreChat：LibreChat 把所有 AI 对话汇集到一个统一、可定制的界面中。LibreChat 还宣布将加入 ClickHouse，为开源的智能体数据栈提供支持。
• AnythingLLM：AnythingLLM 的定位是完全在你电脑上运行的私人 AI 助手，无需账户、无需 API 密钥，也没有 token 限制。它以单个文件发布、没有任何依赖，可在 macOS、Windows 和 Linux 上运行。

与桌面优先的选项不同，Open WebUI 以多用户服务器的形式运行；它的品牌条款是需与各替代品自身许可证比较的许可要点。

注意事项

许可与品牌

• 非 OSI 认可的开源许可：项目方表示，v0.6.6 及之后版本的 Open WebUI 许可证因其品牌条款，不是 OSI 认可的开源许可证。
• 旧代码仍为 BSD-3：截至并包括 v0.6.5 合并的代码仍采用 BSD-3 许可，没有品牌要求，因此仍可从该版本分叉而不受该条款约束。
• 贡献者协议：v0.6.5 之后的新贡献需要签署贡献者许可协议（CLA）。
• 小团队门槛：换品牌豁免的定义是任意 30 天内用户数为 50 名或更少的部署。

安全与运维

• 没有内置 HTTPS：生产部署的 HTTPS 终止交由运维方自行处理。
• 插件运行真实代码：工具（Tools）和函数（Functions）会在服务器上运行任意 Python 代码，拥有与 Open WebUI 进程相同的访问权限。
• 插件默认仅限管理员：默认只有管理员能创建或导入工具和函数，任何获授该权限的人实际上都获得了与 Open WebUI 进程相同的访问权限。
• 历史漏洞：独立安全报道描述了一个高危漏洞，可能导致账户被接管，在某些配置下还可能导致远程代码执行。
• 受影响的功能：该漏洞编号为 CVE-2025-64496，位于用于连接外部模型服务器的 Direct Connections（直接连接）功能中。
• 已修复版本：0.6.34 及更早版本受影响，用户被建议升级到 0.6.35 或更高版本。
• 发布节奏：团队目标是每周发布主要版本，并按需发布错误修复和小更新，但不按固定时间表。

成本与回答质量

• 隐藏的任务调用：标题、标签、搜索查询和自动补全等后台任务默认使用聊天模型；若聊天模型是昂贵的 API 模型，除非另设更便宜的任务模型，否则成本可能大幅增加。
• Ollama 上下文偏短：在显存低于 24 GiB 的 GPU 上，Ollama 默认上下文为 4096 个 token，因此除非调高该值，检索到的段落可能放不进上下文窗口。
• 服务商专有 API：不在所支持协议范围内的服务商，需通过自行构建或取自社区的 pipe 函数接入。

隐私与数据权利

• 默认不共享数据：Open WebUI 默认不向外部服务发送数据；除了调用你所连接的外部模型服务商之外，一切都在你自己的机器或服务器上运行和存储。
• 混合部署：本地推理并不会让单独配置的云端工具、提取服务或嵌入服务变成本地服务。
• 共享链接：每个用户都可在 Settings > Data Controls > Shared Chats > Manage（设置 > 数据控制 > 共享聊天 > 管理）中查看共享的聊天链接，并在那里撤销对任何对话的访问。
• 不收集安装实例：该公司表示，不会从任何安装实例收集对话，无论是否自托管。
• 自愿加入的数据计划：单独的 Open WebUI Data 候补名单会把已有聊天与买方需求相匹配，买方可能以现金、Open WebUI 积分或其他奖励支付。加入候补名单不会上传或分享任何聊天。
• 社区网站条款：通过网站可选功能同步的数据会永久授权给该公司，包括用于机器学习和 AI 训练。
• 同步后仍受许可约束：同步是自愿的，但停止同步后，已同步的数据仍受该许可约束。
• 网站隐私政策：该政策将训练和改进机器学习模型（在适用时须经同意）列为个人信息的用途之一。
• 网站年龄规定：社区网站要求用户年满 18 岁。网站的某些区域可能包含面向成年人的用户内容。

FAQ

Q1. Open WebUI 免费吗？

标准使用是免费的：在完整保留原始品牌的前提下，你可以免费部署用于内部使用。白标、超出小团队门槛后的换品牌，或 Terminals 等企业专属功能，则需要企业许可证。

Q2. Open WebUI 是开源的吗？

源代码是公开的，截至 v0.6.5 的代码采用 BSD-3 许可。从 v0.6.6 起，Open WebUI 许可证增加了品牌条款，项目方自己也表示该许可证并非 OSI 认可。

Q3. Open WebUI 自带 AI 模型吗？

不带。由你连接 Ollama、llama.cpp 或 vLLM 等本地运行器，或者 OpenAI、Anthropic 或其他 OpenAI 兼容服务商的托管 API。

Q4. 可以去掉 Open WebUI 的标志和名称吗？

仅限特定情况：用户数为 50 名或更少的部署、获得书面许可的实质性贡献者，或持有允许修改品牌的企业许可证者。