Skip to main content
Open WebUI(原 Ollama WebUI)是支援多使用者、知識庫、RAG 和私有部署的開源 AI 用戶端。它支援自訂 OpenAI 相容端點,因此可以接入 Ace Data Cloud。本文介紹設定流程。

申請流程

要在 Open WebUI 中接入 Ace Data Cloud,首先到 Ace Data Cloud 控制台,取得您的 API Token,留作備用。 取得 Ace Data Cloud API Key 如果你尚未登入或註冊,會自動跳轉到登入頁面邀請您來註冊和登入,登入註冊之後會自動返回目前頁面。 在首次申請時會有免費額度贈送,可以免費體驗 Ace Data Cloud 的模型服務。

部署並設定 Ace Data Cloud

Open WebUI 透過環境變數接入 OpenAI 相容端點,用 Docker 一行指令即可部署(把 {token} 替換為你的 Token):
開啟 http://你的伺服器IP:3000,第一個註冊的帳號自動成為管理員。注意 Base URL 的路徑規則: 登入後進入 Admin Panel → Settings → Connections 點選「Verify Connection」驗證;在 Settings → Models 中可以篩選並 Pin 常用模型。
除了用環境變數,Open WebUI 也支援在介面裡直接新增連線:進入 Admin Settings → Connections,點選 ➕ 填入 URL(https://api.acedata.cloud/v1)與 API Key 即可,Open WebUI 會自動呼叫 /models 拉取模型清單。詳見官方文件 Starting With OpenAI-Compatible Servers。
Open WebUI Ace Data Cloud Connection 設定介面
MODEL_ID 僅用於示範可選 allow list;留空時會顯示 /models 返回的全部模型。

選擇模型

模型目錄會持續更新。優先使用用戶端自動載入的模型清單;需要手動填寫時,先請求 GET https://api.acedata.cloud/v1/models 取得目前模型 ID,再依用戶端支援的上下文、圖片和工具呼叫能力選擇。

驗證對接

如果不確定問題出在 Open WebUI 還是網路,可以先用 curl 直接驗證端點(把 {token} 替換為你的 Token):
返回 OpenAI 相容的 chat.completion 物件即說明 Token 與端點都已就緒;若返回 HTTP 403 used_up 則表示 Token 有效但餘額不足,到 控制台 儲值即可。

進階:知識庫與多使用者

Open WebUI 的知識庫(RAG)預設用 ChromaDB 儲存向量,嵌入模型可指定 text-embedding-3-large(透過 Ace Data Cloud),文件原文只存在你的伺服器上,僅命中的片段會發給模型。在 Admin Panel → Users 中可以管理使用者角色(Pending / User / Admin);建議把「Default User Role」設為 pending,新使用者需審核後才能使用,避免外人隨意註冊消耗額度。若用 nginx 反向代理,請加上 proxy_buffering off; 與 client_max_body_size 100M;。

常見問題

提示 Connection error / 404

通常是 OPENAI_API_BASE_URL 寫成了 .../openai/v1 或漏了 /v1。改成 https://api.acedata.cloud/v1。

上傳文件後無法對話

在 Admin Panel 的 RAG 設定裡把嵌入模型選為 text-embedding-3-large(OpenAI provider)。

容器重啟後資料遺失

啟動時需掛載資料磁碟區 -v open-webui:/app/backend/data。

了解更多