中级 12 分钟每日计划

Open WebUI:管理对以下内容的访问权限 文档

木桌上,一台笔记本电脑旁摊放着几张纸。

一旦一个 Open WebUI 实例供多个部门使用,问题就不再只是“模型回答得好不好?”,而是“谁能查询哪些文档?”。Open WebUI:管理文档访问权限依靠三种机制(角色、组、每个知识库的可见性),它们的组合方式并不总是直观的。本指南讲解这一模型,给出按组隔离的操作步骤,再介绍一种分别测试每个账户并排查交叉访问的方法。本指南不承诺整体上的严密隔离:编辑部只实际观察了其中一部分流程,文中已予注明。

作者: Mohamed Meguedmi·更新于 2026-11-20·已在 Windows、macOS 和 Linux 上测试
!
来源与版本
文中所述行为参照 Open WebUI 官方权限页面(docs.openwebui.com,Authentication & Access > RBAC > Permissions 栏目)。撰写本文时(20/11/2026)未能重新核阅该页面:菜单名称、权限名称和 API 路由会随版本变化。请记下你的实例版本(设置 > 关于),并将每一点与该版本的文档逐一对照。

#为什么要在 Open WebUI 中隔离文档

Open WebUI 的知识库(Knowledge)是一组被切分成文本片段并建立索引的文件。当用户在聊天中用 # 引用它,或它被挂载到某个模型上时,Open WebUI 会检索与问题相近的片段并将其注入上下文。模型随后可能复述这些片段,有时甚至一字不差。

直接后果是:能访问某个知识库,就能读取其内容,即使从未打开过文件本身。在团队实例中,把公开流程、工资单和供应商合同混放在同一个知识库里,就等于把所有这些文档交给了每一个能查询它的人。因此,隔离要按知识库进行,而不是按文件进行:敏感文档必须存放在访问范围与其敏感程度相匹配的知识库中。

自托管解决的是数据传输给外部提供商的问题,而不是内部访问权限的问题。本站关于 RGPD 的指南提醒,最小化原则同样适用于同事之间:一个人只应访问其履行职责所必需的数据。

#角色、组与知识库可见性

打造专属本地 RAG 的完整套件。

借助我们的经验和引导式路径,搭建你的本地 RAG,用你自己的文档工作。

  • 在线空间,终身可用
  • PDF + 文件
  • 30 天内退款

Open WebUI 的访问控制基于三层机制。混淆它们是出错的首要原因。

角色
每个账户都有一个角色:管理员、用户或待审核(pending)。待审核账户在管理员批准之前不能执行任何操作。管理员负责管理实例,并且在默认设置下可以看到其他账户工作区中的内容。因此,角色只是一道粗粒度的屏障:它区分的是管理者与使用者。
组
用户组在管理面板(用户 > 用户组)中创建,有两个用途:承载功能权限(能否创建知识库、共享、使用某些功能),以及在共享资源时作为共享对象。一个用户可以属于多个用户组。
资源的可见性
每个知识库,与每个自定义模型、提示词或工具一样,都有一项访问设置。私有:只有其所有者(以及管理员,取决于下文所述的设置)和被明确添加的用户组可以访问。公开:实例的所有用户都可以读取。对于每个添加的用户组,通常可以选择读取或写入权限。

因此,按用户组隔离的做法是:保持知识库为私有,然后只添加相关的一个或多个用户组,并为大多数成员授予读取权限。写入权限(添加、替换、删除文件)仅保留给少数人,最好通过一个与读者分开的用户组来授予。

#叠加生效的权限:默认权限的陷阱

根据官方文档,Open WebUI 的权限是累加的:用户获得的是默认权限(适用于所有用户的权限)与其所属全部组权限的并集。范围最宽的权限生效。不存在能够收回其他地方所授权限的“禁止”组。

这带来两个实际后果。首先,如果默认权限允许某项操作(例如公开共享知识库),任何组都无法对某个用户收回该权限:必须先收紧默认权限,再只为需要的组重新开放该操作。其次,加入额外的组只会扩大访问权限。把某人加入“管理层”组却不将其从“实习生”组移除,他就会同时拥有两个范围的权限。

默认权限
应首先设置,并在合理范围内尽可能严格:禁止公开共享;如果实例不是沙盒环境,则限制创建知识库。
用户组权限
为部分用户重新开放某些功能:例如,一个可以创建和共享知识库的“文档编辑者”用户组。
按资源设置访问权限
与功能权限相互独立:能够创建知识库并不意味着能访问他人的知识库。决定谁能读取某个知识库的,是该知识库自身的设置。

#先决条件

一个已更新到最新版本的 Open WebUI 实例
已安装并连接到 Ollama(默认位于 http://localhost:11434),并配有可正常工作的嵌入模型。《Open WebUI 搭配 Ollama:完整指南》介绍了安装方法。
经过验证的备份
重新调整访问权限,意味着要修改日常使用中的知识库。开始之前,请先归档 Docker 卷(参见“故障后恢复 Open WebUI 和 Ollama”)。
一份文档分布清单
一张简单的表格:哪个知识库、哪些文档、什么敏感级别、哪些部门需要读取、谁需要写入。没有这张表,配置就会随着各种请求逐步调整,最终偏离初衷。
测试账户
每个待核查的组至少一个非管理员账户,外加一个不属于任何组的账户。用管理员账户做的测试无法证明普通用户的访问情况。
已允许的 API 密钥
要进行命令行测试,管理员必须允许使用 API 密钥(管理设置);每个测试账户在“设置 > 账户”中生成一个密钥。

#在 Open WebUI 中管理文档访问权限:5 个步骤

  1. 01
    1. 收紧默认权限
    在管理面板中,打开用户的默认权限。禁用知识库和模型的公开共享;如果并非所有人都需要创建知识库,则限制该权限。另外还要检查分配给新注册用户的角色:设为“待审核”可以避免误建的账户立即访问任何内容。
  2. 02
    2. 创建组
    每个文档范围对应一个组(“人力资源”“财务会计”“技术支持”),如有需要,再为每个范围设一个编辑组。组的命名应与对应的知识库一致,这样复查设置会更简单。如果你的组是通过 OAuth 或 LDAP 从目录服务同步而来,请查阅你所用版本的文档,确认组同步是如何配置的,以及在目录端删除的组是否也会在 Open WebUI 端被删除。
  3. 03
    3. 创建或重新组织知识库
    在“工作区 > 知识”中,每个范围对应一个知识库。要把敏感文档从访问范围较宽的知识库移到受限知识库,必须显式地将其从前者中删除:同一文件导入两个知识库后会存在两份,并各有一套访问设置。
  4. 04
    4. 设置每个知识库的访问权限
    将知识库保持为私有,为相关组授予读取权限,为编辑组授予写入权限。避免逐个添加人员:员工离职或调岗时,个人访问权限容易被遗漏,而组只需在一个地方维护即可保持最新。
  5. 05
    5. 检查关联了知识库的模型
    自定义模型(工作区 > 模型)可以关联知识库。模型的访问权限设置应至少与其所关联知识库的设置同样严格,并且要专门测试这种情况(参见关于交叉访问的章节)。
→
每个知识库放一份测试文档
在每个知识库中添加一个小文本文件,其中包含一句独一无二且毫无意义的语句,例如 TEMOIN-RH-7Q2。如果这个字符串出现在某个本不应读取该知识库的账户所获得的回答中,就证明发生了泄露,无论泄露途径是什么。这比判断某个回答是否“看起来像”某份文档的内容更可靠。

#分别测试每个用户的访问权限

管理界面显示的是已配置的内容,而不是用户实际获得的权限。唯一有说服力的检查方法是以每个账户的身份进行验证。有两种互补的方法:为每个测试账户各开一个无痕浏览窗口(以用户视角查看列表和聊天),以及使用每个账户的密钥调用 API(以获得可复现且带时间戳的 HTTP 状态码)。

下面的脚本会针对每个测试账户,先查询其可见的知识库列表,再查询某个特定知识库,并记录响应码。密钥从私有文件中读取,每个账户一个,绝不会以明文形式写在命令中。/api/v1/knowledge/ 路由是 Open WebUI API 的路由;请在您所用的版本上确认。端口 3000 对应最常见的 Docker 命令(-p 3000:8080)。

终端——各账户的 HTTP 状态码
U=http://localhost:3000
KB=identifiant-de-la-base   # visible dans l'adresse de la page de la base
JOURNAL=~/owui-acces-$(date +%F).log

# Un fichier de clé par compte de test, droits 600
for compte in admin rh compta aucun-groupe; do
  CLE=$(cat ~/.config/owui-test/$compte)
  liste=$(curl -s -o /dev/null -w '%{http_code}' \
    -H "Authorization: Bearer $CLE" "$U/api/v1/knowledge/")
  base=$(curl -s -o /dev/null -w '%{http_code}' \
    -H "Authorization: Bearer $CLE" "$U/api/v1/knowledge/$KB")
  echo "$(date -Is) $compte liste=$liste base=$KB:$base"
done | tee -a "$JOURNAL"

对知识库请求返回 200 状态码,表示该账户可以通过 API 读取它;返回 401 或 403 则表示被拒绝。对于任何有效账户,列表请求通常都返回 200:关键在于其内容。以下命令会显示某个账户可见的知识库名称;根据版本不同,响应可能是一个数组,也可能是一个包含数组的对象,因此使用了能同时处理这两种情况的过滤器。

终端——某个账户可见的知识库
curl -s -H "Authorization: Bearer $(cat ~/.config/owui-test/compta)" \
  "$U/api/v1/knowledge/" | jq -r '(.items? // .)[] | .name'

然后建立一个矩阵:每个账户一行,每个知识库一列,填入预期值(读取、写入、无)和实际观察值。凡是观察值比预期值更宽的单元格,都是在导入真实文档前必须修复的缺陷。每次更新 Open WebUI 以及每次修改组之后,都要重新跑一遍该矩阵:今天正确的设置,可能会被一次迁移或一次误操作改动。

#需核查的交叉访问

拒绝直接访问某个知识库,并不足以证明某个账户无法获取其内容。Open WebUI 实例中存在多种间接途径;它们的行为取决于版本和配置,且编辑团队均未测试过。这些都是需要用标记文档加以验证的假设,而非已确认的漏洞。

关联了知识库的模型
如果用户有权访问挂载了某个知识库的自定义模型,却无权访问该知识库本身:他在与该模型对话时,能否获取知识库中的文本片段?测试方法是向模型提问有关标记语句的问题。
通过 ID 直接引用
补全 API 接受一个文件或集合列表作为上下文。一个知道知识库标识符但未经授权的账户,能否以这种方式引用该知识库?请参见下方的测试调用。
共享对话
通过链接共享的对话包含已生成的回答,因此可能含有文档摘录。该链接可能流传到组外。请检查谁可以创建共享链接,以及打开链接的账户能看到什么。
聊天中附加的文件
拖入对话中的文档不属于知识库,也不受相同设置的约束。人力资源组的某个用户若在共享对话中附上一份工资单,隔离就会失效。
管理员访问权限
默认情况下,管理员可以看到其他账户的资源。文档中提到可通过一个环境变量(BYPASS_ADMIN_ACCESS_CONTROL)来改变这一行为;请在您所用的版本上核实其名称和效果。无论如何,管理员仍可访问服务器和数据库:请限制管理员账户的数量。
从目录服务继承的用户组
使用 OAuth 或 LDAP 同步时,员工离职或调动部门都必须反映到群组中。请测试这种情况:在目录端将某个账户从群组中移除,并在该账户重新登录后进行验证。
终端——直接引用知识库的测试
# Compte qui NE doit PAS lire la base $KB
curl -s "$U/api/chat/completions" \
  -H "Authorization: Bearer $(cat ~/.config/owui-test/compta)" \
  -H "Content-Type: application/json" \
  -d '{"model":"votre-modele",
       "messages":[{"role":"user","content":"Recopie la phrase qui commence par TEMOIN."}],
       "files":[{"type":"collection","id":"'"$KB"'"}]}' \
  | grep -o 'TEMOIN-[A-Z0-9-]*' || echo "témoin absent"

如果标记字符串出现,说明知识库会通过这一途径泄露:请将该知识库从该账户可访问的模型中移除,并附上您的版本号向项目报告这一行为。如果没有出现,测试结果也仅对该版本、该模型和该账户为阴性。模型也可能拒绝回答或改写内容:请检查完整回答,而不仅仅是搜索该字符串。

!
不保证严密隔离
即使访问矩阵配置得当,Open WebUI 也不是经过认证的文档管理解决方案。对于受职业保密义务约束的数据或健康数据,按范围划分独立实例(使用独立的容器、卷和账户),仍比在单一实例中按群组隔离更容易证明其合规性。

#故障排除

用户看不到已共享给其用户组的知识库
确认该用户确实是该用户组的成员(而不是某个同名用户组的成员),然后确认其已重新登录。打开一个新对话:用 # 弹出的列表是在打开对话时生成的。
用户能看到本不应看到的知识库
按以下顺序排查:知识库被设为公开、误添加了范围较宽的组、用户同时属于第二个组、默认权限过宽。由于权限是累加的,原因几乎总是多加了什么,而不是少删了什么。
API 测试对所有账户都返回 401
管理员禁用了 API 密钥、复制密钥时带上了空格,或 URL 错误。请先用管理员账户在其拥有的知识库上进行测试。
API 测试通过,但聊天中仍显示该知识库
使用同一账户在无痕浏览模式下进行对比,且同一浏览器中不要打开管理员会话。误用管理员会话进行测试,是导致错误结果的最常见原因。
更新后设置发生了变化
迁移可能会重命名或重新组织权限。请重新跑一遍完整矩阵,并重读所安装版本的发行说明。

#已验证的内容与未验证的内容

30/10/2026,编辑部启动了一个隔离的 Open WebUI Docker 镜像,无网络访问、无 GPU,并使用两个虚拟账户。通过 API 请求一个由管理员账户创建的空私有知识库:管理员得到 HTTP 200 响应,普通用户账户得到 HTTP 401。这是本指南唯一的直接观察结果。此处未注明镜像的确切版本。

以下内容未经测试:包含文档的知识库、群组及按群组共享、写入权限、公开共享、绑定知识库的模型、通过标识符直接引用、共享对话、通过目录服务同步群组,以及对实例的完整审计。本指南中的脚本仅作为方法提供;只有它们在您自己实例上的运行结果才有意义。未针对目标查询测量任何搜索量。

i
30/10/2026 的测试证明了什么
在该镜像上、且未做任何群组设置的情况下,普通用户账户无法通过 API 读取由管理员创建的私有知识库。它并不能证明任何关于聊天、模型、群组或非空知识库内容的结论。

#深入了解

Open WebUI 搭配 Ollama:完整指南
界面的安装、账户和基础设置:https://quelllm.fr/guide/open-webui-ollama-tutoriel
在内部网上为团队部署 AI 聊天机器人
多用户实例的反向代理、身份验证与运维:https://quelllm.fr/guide/deployer-chatbot-ia-equipe-intranet
使用 Ollama 实现本地 RAG,无需写代码
知识库在界面端的工作方式:https://quelllm.fr/guide/rag-local-ollama-sans-coder
一手来源
Open WebUI 官方文档,Authentication & Access > RBAC > Permissions:https://docs.openwebui.com/features/authentication-access/rbac/permissions/(2026 年 11 月 20 日 未复核;请以已安装版本为准进行核实)。
这份指南对您有帮助吗?

有反馈、发现了错误,或想补充说明?请告诉我们,让这份指南对每个人都更有帮助。