Open WebUI
自部署的 ChatGPT-like UI,适合多用户共享、家庭/团队私有部署。
推荐渠道
任意 OpenAI 兼容渠道都行。组合用法:
- 主力:
OpenAI 兼容(GPT-5) - 副力:
Claude 官方(Claude) - 长文本/图像:
Gemini 官方
可以在 Open WebUI 里配多个"模型 connection",让用户从下拉切换。
安装
bash
docker run -d -p 3000:8080 \
--name open-webui \
-v open-webui-data:/app/backend/data \
ghcr.io/open-webui/open-webui:main打开 http://localhost:3000 完成首次注册。
配置
管理员账号 → 右上角头像 → Admin Panel → Settings → Connections:
加 OpenAI 兼容连接
点 + 加新连接:
| 字段 | 值 |
|---|---|
| URL | https://claude-api.org/v1 |
| Key | sk-你的key(绑 OpenAI 兼容) |
| Model IDs | gpt-5.4, gpt-5.4-mini, gpt-5.5, gpt-5.3-codex |
加 Anthropic 连接
需要装 Open WebUI 的 Anthropic 适配 pipe。简单做法:再加一个 OpenAI 兼容连接,把 Claude 当 OpenAI 调(我们后端帮你转协议):
| 字段 | 值 |
|---|---|
| URL | https://claude-api.org/v1 |
| Key | sk-绑Claude官方渠道的key |
| Model IDs | claude-sonnet-4-7, claude-opus-4-7, claude-haiku-4-5 |
一个 Key 一个连接
不要把 Claude 和 OpenAI Key 混进同一个 connection,否则模型路由会乱。每个渠道开一个 connection 最清晰。
验证
回到聊天界面,左上角 model 下拉应该能看到 gpt-5.4 等模型,发个测试消息确认能回复。
多用户场景
Open WebUI 自带用户管理 + 计费看板。但计费精度依赖 model 价格设置:
- Admin Panel → Models → 找到模型 → Edit → 填 input/output price per 1M tokens
- 渠道与价格 页公开了每个模型的实时单价,复制对应数字填到 Open WebUI 的 model price 字段
常见问题
模型下拉是空的
- Connection URL 末尾必须
/v1 - 点 connection 右边的 Refresh 按钮重拉模型列表
- 仍然空:进容器看日志
docker logs open-webui | tail -50,搜 "claude-api"
流式输出闪烁 / 重复
Open WebUI 的渲染对 Claude 的 think token 块支持还在跟进。临时:发消息时勾选 "Disable streaming"。
用户耗光自己的 quota 后能不能限速?
可以。Admin Panel → Users → 单个用户 → 设 token quota / rate limit。和我们后端的限速叠加生效。
更多见 FAQ。
