主题
OpenWebUI
OpenWebUI 是一款开源的 Web 端 ChatGPT 替代品,支持自部署(Docker / Helm),团队场景常用。
接入步骤
OpenWebUI 启动后:
浏览器访问你部署的 OpenWebUI 地址 → 登录管理员账号
「管理员面板」(Admin Panel)→「设置」→「外部连接」/「Connections」
找「OpenAI API」配置项 → 填:
字段 值 OpenAI API Base URL https://s1.why01.top/v1OpenAI API Key 你的 sk-xxxxxxxx点「保存」+「Verify Connection」→ 显示连接成功
回到对话主界面 → 顶部模型选择器 → 应该能看到从
/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/模型,灵活混合本地小模型和远程大模型很方便。