Open WebUI
Open WebUI 是自部署的 ChatGPT-like Web UI,Docker 一键部署,开源免费。提供完整的多用户管理 + token 计费看板 + 多模型同台对比。
关键定位:跟 Chatbox 是"桌面 app"对比,Open WebUI 是 Web 服务(可以让朋友 / 家人 / 团队同时用一份 API 余额)。功能比 Chatbox 重得多——RAG / Pipelines / 函数调用 / 用户配额都内置。
适合谁:需要给团队/家庭部署 AI 助手共享余额;想精细管控每用户配额;愿意 Docker 自部署。
本教程:Docker 起一个 Open WebUI 实例,把 claude-api.org 加为 OpenAI 兼容连接,所有用户共享。
自部署的 ChatGPT-like UI,适合多用户共享、家庭/团队私有部署。
推荐渠道
任意 OpenAI ChatCompletions 协议都能用。组合用法:
- 主力:
OpenAI(GPT-5) - 副力:
Claude 官方(不限客户端)(2.0x) /低价claude(0.5x,质量相对不稳定) /Claude sonnet 折扣(0.5x,仅 Sonnet) — Open WebUI 不是 Claude Code 客户端,不能用Claude 官方(仅限claude code)(1.4x) 那条 - 长文本/图像:
Gemini
可以在 Open WebUI 里配多个"模型 connection",让用户从下拉切换。
安装
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-opus-4-7, claude-sonnet-4-6, claude-haiku-4-5-20251001 |
一个 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"。
图片生成报 JSONResponse / body_iterator
Open WebUI 0.9.5 的内置图片接口按普通 JSON 结果处理,不要在图片参数里额外加 stream: true。如果已经加过,删掉后重试。
复杂生图、参考图和图片修改更建议用本站侧边栏的「图片生成」工具;Open WebUI 更适合做对话、多用户和模型切换。
用户耗光自己的 quota 后能不能限速?
可以。Admin Panel → Users → 单个用户 → 设 token quota / rate limit。和我们后端的限速叠加生效。
更多见 FAQ。
