摘要
本文记录了一套可复制、低风险的 Open WebUI + Ollama 自托管方案，重点讨论二者是否应部署在同一个 Docker Compose 中、认证与管理员模型的设计，以及符合最小权限原则的日常使用方式。本文面向已有 Docker / 反向代理经验的读者，采用工程化视角，避免与具体路径、端口、域名等敏感信息绑定。
1. Open WebUI 的定位
Open WebUI 是为大语言模型交互设计的通用前端（Chat UI 层）：
- 不包含模型权重
- 不参与推理计算
- 通过标准化接口（如 OpenAI 风格 API）与后端推理引擎通信
其职责聚焦在用户交互、会话管理、权限控制与系统配置，而非模型训练或推理本身。
2. 与 Ollama 放在同一个 Compose 中是否合理
2.1 结论
在“单机一体化服务”的使用场景下，将 Open WebUI 与 Ollama 放在同一个 Docker Compose 文件中是高度合理的默认选择。
2.2 合理性依据
生命周期一致
- WebUI 的存在依赖于推理后端
- 二者在部署、停止、迁移时通常同步进行
安全边界清晰
- Ollama 仅通过 Docker 内部网络暴露
- 不需要将推理端口直接暴露到宿主机或公网
运维成本低
- 单一 compose 文件
- 两个数据卷（配置 / 模型）即可完整备份与恢复
故障域符合依赖关系
- 推理后端不可用时，前端本身亦无使用价值
2.3 何时不建议放在一起
- Ollama 作为平台级基础服务，被多个前端或应用共享
- WebUI 与 Ollama 部署在不同物理机 / 虚拟机
- 前端需要频繁更换，而推理后端长期稳定
3. Open WebUI 的认证机制
3.1 是否存在网页端认证
默认启用认证机制，访问 WebUI 需要登录账号密码。
支持的模式包括：
- 内置账号密码认证（默认）
- 关闭注册，仅允许管理员创建用户
- 单用户免登录模式（仅适合严格内网或测试）
- SSO / 反向代理可信头（高级用法）
在对外提供访问的场景下，必须避免免登录模式。
4. 管理员模型说明
4.1 第一个用户的角色
- 第一次访问 WebUI 创建的第一个账号自动成为管理员
- 无需额外配置或命令行操作
4.2 管理员权限
管理员可执行系统级操作：
- 全局设置管理
- 用户创建与删除
- 模型与 API 配置
- 功能模块开关控制
普通用户仅具备聊天与会话管理权限，无法访问管理界面。
5. 推荐的权限使用习惯（最小权限原则）
5.1 账号角色划分
- 管理员账号：
- 仅用于系统配置与维护
- 不参与日常聊天
- 相当于系统中的 root 用户
- 普通用户账号：
- 日常使用
- 聊天与会话管理
- 无系统级权限
5.2 推荐操作流程
- 首次启动服务
- 创建第一个账号（自动管理员）
- 关闭公开注册
- 由管理员创建一个普通用户账号
- 日常仅使用普通用户登录
该模式可显著降低误操作风险与安全暴露面。
6. 数据与隔离说明
- 用户聊天记录按账号隔离
- 普通用户无法查看其他用户会话
- 管理员默认也不读取普通用户聊天内容
7. 总结
- Open WebUI 是面向 AI 模型的通用交互前端，而非通用 Web 框架
- 在单机部署场景下，与 Ollama 同 Compose 属于高合理性方案
- 默认具备认证与管理员模型
- 采用“管理员 + 普通用户”的分权使用方式，符合工程最佳实践
该架构在安全性、可维护性与可迁移性之间取得了良好平衡，适合长期稳定运行。