Open WebUI

Open WebUI を展開し管理者としてゲートウェイ接続を管理します。

インストールと準備

Docker をインストールして Open WebUI Quick Start に従うか、以下のコマンドを実行します。アカウントと設定を保持するため名前付きボリュームを残します。http://localhost:3000 を開き、最初の管理者アカウントを作成します。 routerra.ai Keysで接続キーを作成し、ゲートウェイ一覧から許可された 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 を選び短文を送ります。表示されなければ接続スイッチと許可リストを確認して保存・更新します。再起動時、DB 設定が OPENAI_API_BASE_URL と OPENAI_API_KEY より優先されるため管理画面で変更します。ENABLE_PERSISTENT_CONFIG=False で環境変数を優先できますが、管理画面の変更は保存されません。通信エラーは docker logs open-webui とコンテナーの外向き HTTPS を確認します。