理解设置
Open WebUI 包含两个独立的设置区域,而不是一个。
Open WebUI 从第一天起就是多用户的。即使您是唯一使用它的人,系统架构也假定同一个实例上可能会有很多用户。这意味着该平台需要两个层级的配置:一个是控制实例的管理员配置,另一个是控制各自体验的每个独立用户配置。
两个设置区域
管理员设置(全局)
| 位置 | 个人头像 > 管理员设置,或 管理员面板 > 设置 |
| 访问权限 | 仅限管理员 |
| 范围 | 整个实例和所有用户 |
管理员设置控制着有关 Open WebUI 实例本身的一切:API 连接、功能开关、安全策略和默认行为。可以将其视为整栋大楼 的控制面板。它决定了安装了什么以及对所有人可用。
此处包含的配置示例:
- 连接到 Ollama、OpenAI 和其他提供商
- 启用或禁用网络搜索、图像生成和代码执行
- 默认模型选择和参数预设
- RBAC(基于角色的访问控制)策略、SSO 配置和注册限制
用户设置(个人)
| 位置 | 个人头像 > 设置 |
| 访问权限 | 所有用户(包括管理员) |
| 范围 | 仅限当前用户自身 |
用户设置控制个人偏好:您的默认模型、界面主题、语言、通知偏好,以及由管理员已经启用的各项特性的个人开关。可以将其视为您自己房间里的温控器。您可以为自己调节温度,但只能在大楼系统提供的范围内调节。
此处包含的配置示例:
- 偏好的默认模型和系统提示词(System Prompt)
- 界面主题和语言
- 个人 API Key(如果启用了 直接连接)
- 各项功能的个人开关,例如自动补全或富文本输入
它们是如何协同工作的
许多功能都遵循两层模式:
- 管理员决定某项功能是否可用(管理员设置)
- 每个用户自行决定是否要在个人层面上使用它(用户设置)
示例:自动补全(AI 驱动的键入建议)
| 层级 | 设置位置 | 效果 |
|---|---|---|
| 管理员启用它 | 管理员设置 > 界面 | 使自动补全在实例上可用 |
| 用户启用它 | 设置 > 界面 | 针对您个人开启自动补全 |
如果管理员在全局禁用了某项功能,用户将无法为自己启用它。管理员设置始终是上限天花板。
这种模式同样适用于网络搜索、图像生成、直接连接、代码解释器等功能。管理员控制什么是可能的。用户控制自己想要什么。
快速参考
| 管理员设置 | 用户设置 | |
|---|---|---|
| 范围 | 整个实例(所有用户) | 仅限单个用户 |
| 访问权限 | 仅限管理员 | 所有人 |
| 控制项 | API 连接、功能开关、安全性、默认值 | 主题、默认模型、个人偏好 |
| 覆盖行为 | 无法被普通用户覆盖 | 可以在管理员允许的范围内进行自定义 |
常见场景
“我在我的设置中启用了一项功能,但它没有起作用。” 请先检查管理员是否已经在全局启用了该功能。只有在管理员于实例层面上使该功能可用时,您的个人开关才会生效。
“我是管理员。我在哪里配置与 OpenAI 或 Ollama 的连接?” 管理员设置 > 外部连接。这些连接是全实例范围的,并由所有用户共享。
“我想要使用自己的 API Key,且不与服务器共享。” 如果管理员启用了直接连接,您可以在用户设置 > 外部连接中添加个人 API Key。参阅 直接连接。
“我设置了系统提示词,但管理员的模型设置覆盖了它。” 管理员在工作区中配置的模型级设置的优先级要高于个人设置。有关完整的优先级层级,请参阅 对话参数。
从 管理员设置 > 外部连接 开始,连接您的模型提供商(Ollama、OpenAI 等),然后探索 管理员设置 > 界面 以启用或禁用面向用户的功能。