理解设置
Open WebUI 有两个独立的设置区域,而不是一个。
Open WebUI 从一开始就是面向多用户设计的。即使你是唯一使用者,系统架构也假定同一个实例上可能会有很多用户。因此平台需要两层配置:一层属于控制整个实例的管理员,另一层属于控制个人体验的每位用户。
两个设置区域
管理员设置(全局)
| 位置 | 头像菜单 > Admin Settings,或 Admin Panel > Settings |
| 访问权限 | 仅管理员 |
| 作用范围 | 整个实例和所有用户 |
管理员设置控制的是 Open WebUI 实例本身:API 连接、功能开关、安全策略和默认行为。你可以把它理解为整栋楼的控制面板——它决定了哪些东西被安装、哪些能力对所有人开放。
典型示例:
- 与 Ollama、OpenAI 及其他提供商的连接
- 启用或禁用网页搜索、图片生成与代码执行
- 默认模型选择与参数预设
- RBAC 策略、SSO 配置和注册限制
用户设置(个人)
| 位置 | 头像菜单 > Settings |
| 访问权限 | 所有用户(包括管理员) |
| 作用范围 | 仅当前用户本人 |
用户设置控制的是个人偏好:你的默认模型、界面主题、语言、通知偏好,以及管理员已开启功能上的个人开关。你可以把它理解为自己房间里的恒温器——你可以调整属于自己的体验,但前提仍由整栋楼的基础设施决定。
典型示例:
- 偏好的默认模型与 system prompt
- 界面主题与语言
- 个人 API 密钥(如果启用了 Direct Connections)
- 自动补全、富文本输入等功能的个人开关
它们如何协同工作
很多功能都遵循一种双层模式:
- 管理员决定该功能是否可提供(管理员设置)
- 每位用户决定自己是否要使用(用户设置)
示例:自动补全(AI 驱动的输入建议)
| 层级 | 设置位置 | 效果 |
|---|---|---|
| 管理员启用 | Admin Settings > Interface | 让自动补全在实例中可用 |
| 用户启用 | Settings > Interface | 只为你本人打开自动补全 |
如果管理员在全局范围关闭某个功能,用户无法自行启用它。管理员设置永远是上限。
这种模式适用于网页搜索、图片生成、direct connections、code interpreter 等多种功能。管理员控制什么是可能的,用户控制自己想要什么。
快速对照
| Admin Settings | User 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,按需为用户启用或禁用功能。