Skip to main content
Open WebUI 是一个可自托管的 Web 界面，用于与各种大语言模型交互。通过在 Open WebUI 中添加 Sub2API 作为 OpenAI 兼容连接，你可以通过浏览器访问 GPT、Claude、Gemini、Grok 等多种模型，并与团队成员共享使用。

​
前置条件

  • 已部署 Open WebUI 实例（Docker 或本地安装）
  • 已获取 Sub2API API Key（详见 创建 API Key）

​
配置步骤

1

访问管理面板

以管理员身份登录 Open WebUI，点击右上角头像或菜单进入「设置」/「Admin Panel」。
截图占位：此处可插入实际客户端配置截图
2

进入连接设置

在设置菜单中找到「Connections」或「连接」选项。选择「OpenAI API」连接类型。
截图占位：此处可插入实际客户端配置截图
3

添加新连接

点击「添加连接」或「Add Connection」按钮。
截图占位：此处可插入实际客户端配置截图
4

填写连接信息

根据提示填写以下配置：
TODO：请在后台确认实际配置后填写。（API 路径 /v1 及 Open WebUI 版本兼容性需确认）
截图占位：此处可插入实际客户端配置截图
5

保存并验证

点击「保存」按钮。Open WebUI 会自动验证连接并获取可用模型列表。
截图占位：此处可插入实际客户端配置截图
6

启用模型

在模型列表中选择你希望在 WebUI 中启用的模型，打开对应开关。
建议先启用常用的 2-3 个模型进行测试，确认正常后再启用更多模型。
截图占位：此处可插入实际客户端配置截图

​
版本要求

TODO：请在后台确认实际配置后填写。（请确认支持的 Open WebUI 最低版本要求）

​
故障排查

  • 确认 API URL 和 API Key 填写正确
  • 检查 Open WebUI 日志获取详细错误信息
  • 参考 API Key 无效排查
  • 确认 Open WebUI 服务器可以访问 https://sub2api.ruilinlu.com
  • 检查服务器防火墙或代理设置
  • 参考 Base URL 配置