Skip to content

OpenWebUI

OpenWebUI 是一款开源的 Web 端 ChatGPT 替代品,支持自部署(Docker / Helm),团队场景常用。

接入步骤

OpenWebUI 启动后:

  1. 浏览器访问你部署的 OpenWebUI 地址 → 登录管理员账号

  2. 管理员面板」(Admin Panel)→「设置」→「外部连接」/「Connections

  3. 找「OpenAI API」配置项 → 填:

    字段
    OpenAI API Base URLhttps://s1.why01.top/v1
    OpenAI API Key你的 sk-xxxxxxxx
  4. 点「保存」+「Verify Connection」→ 显示连接成功

  5. 回到对话主界面 → 顶部模型选择器 → 应该能看到从 /v1/models 自动拉取的模型列表

多用户场景

OpenWebUI 支持多用户。所有用户共享你配置的这个 Key 的余额——这意味着:

  • 适合信任的小团队(同事、家人共享)
  • 不适合公开开放给陌生人用——任何用户都能消耗这个 Key 的余额
  • 公开场景请考虑给每个用户单独发 Key + 用 OpenWebUI 的「按用户限额」功能

常见问题

模型列表不出现

  • 点「Refresh」/「刷新模型列表」按钮
  • 检查 OpenAI API Base URL 是否带 /v1
  • 看 OpenWebUI 日志(docker logs openwebui)是否有连接错误

流式回答经常断

OpenWebUI 默认有较长 timeout。如果仍频繁中断,调整 OpenWebUI 配置中 OPENAI_API_TIMEOUT 环境变量到 300 秒以上。

怎么禁某个模型给某个用户

OpenWebUI Admin Panel → 「Model Whitelist」/「Permissions」按用户组配置。

同时接 Ollama + why01

OpenWebUI 原生支持同时接 Ollama 和多个 OpenAI 兼容 provider。对话框里一个会话可切换 provider/模型,灵活混合本地小模型和远程大模型很方便。