# Open WebUI 的隐患藏在 Docker 卷和许可证里

> 客户的全部聊天记录都存放在一个 Docker 卷里，在界面上换成客户 logo 还可能违反许可证。

原文: https://fdetimes.net/zh/tools/open-webui-client-deployment-volume-license/

Open WebUI 的 Quick Start 页面里有一段简短的话，每个前线部署工程师（FDE）都应该抄进运维手册（runbook）：聊天记录、用户和配置都存放在 Docker 卷里，这个卷在更新后依然保留，系统绝不能脱离它运行。

第二件要记住的事在许可证里。Open WebUI 许可证自 2025 年 4 月 19 日的 v0.6.6 起生效，禁止修改、删除或遮挡“Open WebUI”品牌标识。

客户部署能否顺利，就取决于这两段话。安装本身不费事，难的是数据由谁掌握，以及客户能拿正在使用的界面做什么。

## Open WebUI 在客户现场解决什么问题？

官方文档把 Open WebUI 描述为一个可扩展、功能丰富、易用的自托管 AI 平台。它支持 Ollama 和 OpenAI 兼容 API，因此不绑定任何供应商：模型可以在客户的 GPU 机器上本地运行，也可以跑在云端。

这让它很适合 FDE 经常遇到的场景：客户已经有模型或内部网关，只缺一个员工能直接上手的聊天界面。不需要写前端。但每个连接都得手动配置，因为 Open WebUI 本身不带任何模型。

## 谁创建第一个账号，谁就掌控系统

Quick Start 写得很明白：第一个创建的账号会成为管理员，负责管理用户和全系统的所有设置。在笔记本上，这个细节无关紧要。到了客户现场，如果为了快速测试用个人邮箱注册，就等于把系统最高权限交给了一个即将离开项目的人。

第一次搭建时，按这个顺序来：从第一次运行就挂载卷，然后由客户的负责人创建第一个账号，或者使用客户自有的服务账号。

接下来，管理员点击头像，在管理区打开 Settings > Connections，填入客户的 Ollama 端点或 OpenAI 兼容网关。如果模型选择器仍然是空的，先别急着改界面：在运行容器的机器上用 `curl` 调用该端点，判断问题出在网络、网关还是连接凭证。

## 卷就是客户数据，要当作数据库对待

聊天记录、用户和配置都存放在卷里，所以它实际上是一个数据库，记录了员工向模型问过的所有内容，其中可能包括敏感信息。如果有人在清理服务器时删掉它，所有账号和历史记录都会一起消失。

**要点:** 聊天界面一个下午就能换掉；客户的聊天数据一旦丢失，就无法恢复。

交付前，以书面形式约定三件事：卷放在哪块磁盘上、属于谁的基础设施；谁负责备份；项目结束后数据如何处理。

## 数字 50 不是席位上限

许可证有一条正式的例外：如果系统在 30 天内的用户不超过 50 人，允许更换品牌。独立分析机构 Aliteq 强调，这个数字不是席位上限，它只限制更换品牌。

用一个假设的例子说明后果。某客户为法务部门的 40 人做试点，在界面上放了公司 logo：仍在例外范围内。三个月后，客户把它开放给 300 名员工。

系统也许照常运行，但只要 30 天内的用户超过 50 人，客户的 logo 就得撤下，除非客户持有明确允许更换品牌的企业许可证。

小 logo 也不能例外。Aliteq 援引 Open WebUI 的文档指出，即便是 20 像素高的 logo 也算联合品牌（co-branding）。所以 logo 问题要在项目启动时就提出来，而不是留到上线计划的最后。

## 企业版：该问什么，找谁确认

厂商主页列出了面向强监管行业的企业功能：SSO、RBAC、审计日志、数据驻留，以及本地部署或离线隔离（air-gapped）部署。这是一份营销清单，并不代表厂商对即将安装的版本做出了任何承诺。

因此，拿出客户的安全检查清单，标出依赖这六项以及更换品牌权利的条目。给厂商发邮件，逐项询问这些内容是否包含在客户打算购买的许可证中，并要求书面答复。

把答复附进项目档案。厂商没有确认的条目，一律记为未解决的风险，而不是作为已有功能写进计划。

## 先学什么，简历上怎么写

第一项要练的技能是 Docker 卷和网络：数据存在哪里、怎么备份、容器走哪条路由访问模型服务器。第二项较少有人重视：读懂开源许可证，清楚哪些事能向客户承诺，哪些不能。

简历上不要笼统地写“做了一个聊天机器人”。应该写：部署了连接内部模型的自托管聊天界面，把管理员权限移交给客户，建立了备份流程，并在上线前核查了许可证。如果岗位描述提到本地部署或离线隔离部署，把这一条放在最前面。

让容器跑起来只需几分钟。卷放在哪里、谁持有管理员权限、屏幕上显示谁的 logo，这三个问题要在客户第一位员工登录之前回答清楚。

**本周动手试试:**

- 挂载卷运行 Open WebUI，创建几个对话，删除容器后重新运行，确认数据仍然保留
- 进入 Settings > Connections，分别添加一个 Ollama 连接和一个 OpenAI 兼容连接，并把步骤整理成一页简短的 runbook
- 起草一封给厂商的邮件，询问企业版是否包含 SSO、RBAC、审计日志、数据驻留、离线隔离部署以及更换品牌的权利

## 信源

- [Open WebUI](https://docs.openwebui.com/)

- [Quick Start | Open WebUI](https://docs.openwebui.com/getting-started/quick-start/)

- [GitHub - open-webui/open-webui: User-friendly AI Interface (Supports Ollama, OpenAI API, ...)](https://github.com/open-webui/open-webui)

- [Open WebUI License](https://docs.openwebui.com/license/)

- [Open WebUI: Self-Hosted AI Platform](https://openwebui.com/)

- [Open WebUI License, Over 50 Users Without an Enterprise License?](https://aliteq.com/open-webui-license-explained-2026)
