Open WebUI

部署 Open WebUI，并由管理员管理服务器网关连接。

安装与准备

安装 Docker，按 Open WebUI 快速开始部署，或运行下方命令。保留命名数据卷以保存账号和设置。打开 http://localhost:3000 并创建首个管理员账号。 在 routerra.ai 密钥页创建连接密钥，并从网关模型列表获取获准 ID。

配置连接

以管理员身份打开 Settings → Admin → Connections → Manage OpenAI API Connections → Add Connection。URL 填 https://routerra.ai/v1，API Key 填 YOUR_API_KEY，使用默认 OpenAI 兼容类型并启用后保存。模型通常由该连接的 /models 获取；无法发现时在 Model IDs 白名单填 YOUR_MODEL_ID。这是按实例权限共享的服务器连接，不是个人浏览器的 Direct Connection。

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

选择模型与排查错误

在新聊天中选择 YOUR_MODEL_ID 并发送短消息。缺少模型时检查连接开关与白名单，再保存刷新列表。数据库已存设置会在重启时覆盖 OPENAI_API_BASE_URL 和 OPENAI_API_KEY，应直接编辑管理员连接。ENABLE_PERSISTENT_CONFIG=False 可强制使用环境变量，但管理员修改不再持久化。网络错误时查看 docker logs open-webui 并检查容器出站 HTTPS。