Skip to content

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",让用户从下拉切换。

安装

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 PanelSettingsConnections

加 OpenAI 兼容连接

+ 加新连接:

字段
URLhttps://claude-api.org/v1
Keysk-你的key(绑 OpenAI 渠道)
Model IDsgpt-5.4, gpt-5.4-mini, gpt-5.5, gpt-5.3-codex

加 Anthropic 连接

需要装 Open WebUI 的 Anthropic 适配 pipe。简单做法:再加一个 OpenAI 兼容连接,把 Claude 当 OpenAI 调(我们后端帮你转协议):

字段
URLhttps://claude-api.org/v1
Keysk-绑Claude官方(不限客户端)渠道的key
Model IDsclaude-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

本站为 API 反向代理服务,与 Anthropic / OpenAI / Google 无关联。