返回首页

Open WebUI

Open WebUI 是一款功能完整的自部署 AI 对话 Web 界面，支持多用户、RAG、函数调用等。

💡 Open WebUI 是多人场景：部署前先想清楚是「所有用户共用一个 Picklyone Key」还是「每人一个 Key」，下方的 Picklyone 使用建议 里有两种方案的对比。

安装（Docker）

docker run -d \
  -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

启动后访问 http://localhost:3000，首次进入会要求创建管理员账号。

配置步骤

  1. 登录后点右上角头像 → 设置
  2. 左侧选择 Connections（连接）
  3. 在 OpenAI API 区块：
    • API Base URL：https://api.picklyone.com/v1
    • API Key：pk_live_xxxxxxxxxxxxxxxx
  4. 点保存旁边的刷新按钮，验证连接
  5. 切到 Models 页，勾选你想展示给用户的模型

启动时直接注入配置

docker run -d \
  -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.picklyone.com/v1 \
  -e OPENAI_API_KEY=pk_live_xxxxxxxxxxxxxxxx \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

Picklyone 使用建议

  • 方案 A：团队共享一个 Key（推荐新手）：在 Open WebUI 后端注入单个 Picklyone Key，所有用户聚合扣费。给这个 Key 设一个团队级 日限额（比如 $50/天），超出会所有人一起停，防止某个用户失控。
  • 方案 B：按用户分 Key：如果 Open WebUI 有 5–10 个固定用户，给每人创一个 Picklyone 子 Key，Open WebUI 里让用户自己填 Key。API 日志 就能天然按人统计消耗。Open WebUI 的 Connections 设置允许用户覆盖管理员配置。
  • 模型准入控制：在 Picklyone Key 的 允许模型 里设白名单，任何用户在 Open WebUI 里试图切换到没授权的模型都会被 Picklyone 挡掉，不影响其他用户。
  • Embedding / RAG 注意：Picklyone 当前聚焦对话类模型，如果你在 Open WebUI 里开了 RAG，embedding 模型需要单独配一个 provider（例如本地 Ollama），不要指望 Picklyone 端点返回 embedding。

常见问题

  • 模型列表为空：Open WebUI 会调用 /v1/models 获取模型。确认 Key 没被禁用，或者在 Admin Panel → Models 里手动添加
  • 多用户共享一个 Key：所有用户的请求都会记在同一个 Picklyone API Key 上。建议在 Picklyone 控制台为 Open WebUI 专门创建一个 Key，方便核算
  • RAG / 嵌入模型：如果要用 embedding 功能，在 Admin Panel → Documents 里配置 embedding 模型，也走同一个 Picklyone Base URL