open-webui 怎么配置第三方 API

Open WebUI 是自托管的聊天界面，支持任意 OpenAI 兼容后端。配置分“界面里改”和“环境变量”两种方式。

方式一：界面配置

管理员账号登录 → Admin Settings → Connections → OpenAI API：

• API Base URL：https://relay.example.com/v1
• API Key：你的 key

保存后点刷新，模型列表会出现在聊天页顶部的选择器里。

方式二：环境变量（Docker）

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL="https://relay.example.com/v1" \
  -e OPENAI_API_KEY="sk-your-key" \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

环境变量适合一次性部署，改完重启容器生效。

验证

打开 http://localhost:3000，选一个模型，发一句“reply with OK”。再看 Admin → Settings 的模型列表是否完整。

常见报错

• 模型列表为空：网关不提供 /models，在界面里手动添加模型。
• 401：key 没传进容器，检查环境变量名是否拼错。
• 流式输出卡住：网关 SSE 不兼容，先在设置里关闭流式。
• 容器重启后配置丢失：没有挂载 /app/backend/data 卷。

注意

• 多人使用时给每个用户建独立账号，不要共用管理员。
• 公网部署务必加反向代理与访问控制，别把带 key 的界面直接暴露。