跳到主要内容

理解设置

Open WebUI 包含两个独立的设置区域,而不是一个。

Open WebUI 从第一天起就是多用户的。即使您是唯一使用它的人,系统架构也假定同一个实例上可能会有很多用户。这意味着该平台需要两个层级的配置:一个是控制实例的管理员配置,另一个是控制各自体验的每个独立用户配置。


两个设置区域

管理员设置(全局)

位置个人头像 > 管理员设置,或 管理员面板 > 设置
访问权限仅限管理员
范围整个实例和所有用户

管理员设置控制着有关 Open WebUI 实例本身的一切:API 连接、功能开关、安全策略和默认行为。可以将其视为整栋大楼的控制面板。它决定了安装了什么以及对所有人可用。

此处包含的配置示例:

  • 连接到 Ollama、OpenAI 和其他提供商
  • 启用或禁用网络搜索、图像生成和代码执行
  • 默认模型选择和参数预设
  • RBAC(基于角色的访问控制)策略、SSO 配置和注册限制

用户设置(个人)

位置个人头像 > 设置
访问权限所有用户(包括管理员)
范围仅限当前用户自身

用户设置控制个人偏好:您的默认模型、界面主题、语言、通知偏好,以及由管理员已经启用的各项特性的个人开关。可以将其视为您自己房间里的温控器。您可以为自己调节温度,但只能在大楼系统提供的范围内调节。

此处包含的配置示例:

  • 偏好的默认模型和系统提示词(System Prompt)
  • 界面主题和语言
  • 个人 API Key(如果启用了 直接连接
  • 各项功能的个人开关,例如自动补全或富文本输入

它们是如何协同工作的

许多功能都遵循两层模式

  1. 管理员决定某项功能是否可用(管理员设置)
  2. 每个用户自行决定是否要在个人层面上使用它(用户设置)

示例:自动补全(AI 驱动的键入建议)

层级设置位置效果
管理员启用它管理员设置 > 界面使自动补全在实例上可用
用户启用它设置 > 界面针对您个人开启自动补全
核心规则

如果管理员在全局禁用了某项功能,用户将无法为自己启用它。管理员设置始终是上限天花板。

这种模式同样适用于网络搜索、图像生成、直接连接、代码解释器等功能。管理员控制什么是可能的。用户控制自己想要什么


快速参考

管理员设置用户设置
范围整个实例(所有用户)仅限单个用户
访问权限仅限管理员所有人
控制项API 连接、功能开关、安全性、默认值主题、默认模型、个人偏好
覆盖行为无法被普通用户覆盖可以在管理员允许的范围内进行自定义

常见场景

“我在我的设置中启用了一项功能,但它没有起作用。” 请先检查管理员是否已经在全局启用了该功能。只有在管理员于实例层面上使该功能可用时,您的个人开关才会生效。

“我是管理员。我在哪里配置与 OpenAI 或 Ollama 的连接?” 管理员设置 > 外部连接。这些连接是全实例范围的,并由所有用户共享。

“我想要使用自己的 API Key,且不与服务器共享。” 如果管理员启用了直接连接,您可以在用户设置 > 外部连接中添加个人 API Key。参阅 直接连接

“我设置了系统提示词,但管理员的模型设置覆盖了它。” 管理员在工作区中配置的模型级设置的优先级要高于个人设置。有关完整的优先级层级,请参阅 对话参数

首次担任管理员?

管理员设置 > 外部连接 开始,连接您的模型提供商(Ollama、OpenAI 等),然后探索 管理员设置 > 界面 以启用或禁用面向用户的功能。

This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.