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。