跳到主要内容

理解设置

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

Open WebUI 从一开始就是面向多用户设计的。即使你是唯一使用者,系统架构也假定同一个实例上可能会有很多用户。因此平台需要两层配置:一层属于控制整个实例的管理员,另一层属于控制个人体验的每位用户。


两个设置区域

管理员设置(全局)

位置头像菜单 > Admin Settings,或 Admin Panel > Settings
访问权限仅管理员
作用范围整个实例和所有用户

管理员设置控制的是 Open WebUI 实例本身:API 连接、功能开关、安全策略和默认行为。你可以把它理解为整栋楼的控制面板——它决定了哪些东西被安装、哪些能力对所有人开放。

典型示例:

  • 与 Ollama、OpenAI 及其他提供商的连接
  • 启用或禁用网页搜索、图片生成与代码执行
  • 默认模型选择与参数预设
  • RBAC 策略、SSO 配置和注册限制

用户设置(个人)

位置头像菜单 > Settings
访问权限所有用户(包括管理员)
作用范围仅当前用户本人

用户设置控制的是个人偏好:你的默认模型、界面主题、语言、通知偏好,以及管理员已开启功能上的个人开关。你可以把它理解为自己房间里的恒温器——你可以调整属于自己的体验,但前提仍由整栋楼的基础设施决定。

典型示例:

  • 偏好的默认模型与 system prompt
  • 界面主题与语言
  • 个人 API 密钥(如果启用了 Direct Connections
  • 自动补全、富文本输入等功能的个人开关

它们如何协同工作

很多功能都遵循一种双层模式

  1. 管理员决定该功能是否可提供(管理员设置)
  2. 每位用户决定自己是否要使用(用户设置)

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

层级设置位置效果
管理员启用Admin Settings > Interface让自动补全在实例中可用
用户启用Settings > Interface只为你本人打开自动补全
关键规则

如果管理员在全局范围关闭某个功能,用户无法自行启用它。管理员设置永远是上限。

这种模式适用于网页搜索、图片生成、direct connections、code interpreter 等多种功能。管理员控制什么是可能的,用户控制自己想要什么


快速对照

Admin SettingsUser Settings
作用范围整个实例(所有用户)单个用户
访问权限仅管理员所有人
控制内容API 连接、功能开关、安全、默认值主题、默认模型、个人偏好
覆盖行为用户无法覆盖可在管理员允许范围内自定义

常见场景

“我在自己的设置里打开了某个功能,但它不生效。” 请先确认管理员是否已在全局范围内启用该功能。只有当管理员先让实例层面可用时,你的个人开关才会生效。

“我是管理员。OpenAI 或 Ollama 的连接要在哪里配置?” 前往 Admin Settings > Connections。这些连接是实例级的,会被所有用户共享。

“我想用自己的 API 密钥,但不想和服务器共享。” 如果管理员启用了 Direct Connections,你可以在 User Settings > Connections 中添加个人 API 密钥。详见 Direct Connections

“我设置了 system prompt,但管理员在 Workspace 里的模型设置把它覆盖了。” 管理员在 Workspace 中配置的模型级设置优先于个人设置。完整优先级见 Chat Parameters

第一次当管理员?

建议先从 Admin Settings > Connections 开始,连接模型提供商(Ollama、OpenAI 等),然后再进入 Admin Settings > Interface,按需为用户启用或禁用功能。

本内容仅供参考,不构成任何保证、担保或合同承诺。Open WebUI 按“现状”提供。请参阅您的许可协议 以了解适用条款。