LobeChat / LobeHub

在 LobeChat / LobeHub 設定共享伺服器憑證或個人 OpenAI 供應商。

安裝與準備

自架實例需安裝 Docker，並依 LobeHub 目前的 Docker 部署文件完成資料庫、物件儲存及身分驗證設定。保留對應版本的 Compose 檔案與既有密鑰；下方片段僅補充應用程式環境變數，並非完整部署。開啟實例登入，準備 routerra.ai 金鑰及其可用的精確模型 ID。

設定連線

伺服器統一提供時，在 Lobe 應用服務設定 OPENAI_API_KEY=YOUR_API_KEY、OPENAI_PROXY_URL=https://routerra.ai/v1 和 OPENAI_MODEL_LIST=-all,+YOUR_MODEL_ID，然後重建服務。-all 隱藏內建模型，+ 加入精確 ID，不會授予網關權限。伺服器金鑰供實例獲准使用者使用。若使用個人金鑰，開啟 Settings → Language Model → OpenAI，啟用供應商，填寫 API Key 及自訂 API Proxy Address https://routerra.ai/v1，再於模型管理新增並啟用精確模型。

OPENAI_API_KEY=YOUR_API_KEY
OPENAI_PROXY_URL=https://routerra.ai/v1
OPENAI_MODEL_LIST=-all,+YOUR_MODEL_ID

選擇模型與排除錯誤

建立對話選擇 OpenAI 和 YOUR_MODEL_ID 傳送文字。缺少模型通常是供應商或模型未啟用，或修改環境變數後未重建應用程式。個人設定仍指向其他位址時，先修正已儲存的代理和金鑰。401 時區分實例登入驗證與網關金鑰。上游錯誤請查應用容器日誌；介面啟用視覺或工具不會賦予模型這些能力。