架設自己的 Open WebUI：串接模型、管理帳號與保存對話

如果你手邊已經有各家大型模型的 API Key，想架一個屬於自己或小團隊的網頁聊天入口，Open WebUI 是最省心的單容器方案之一：內建多使用者帳號、對話紀錄、知識庫文件與模型切換，裝好就能用。

本文用 Zenavo 的 Open WebUI 範本，把介面部署到你自己的伺服器上，再串接外部模型 API。如果你想對比包含 PostgreSQL、Redis 與獨立 S3 儲存空間的多人工作台，也可以參考 LobeHub 部署指南。

範本本身不包含本機模型或 GPU 推論；伺服器、Zenavo 平台與上游模型 API 分別計費。

部署 Open WebUI

先在 Zenavo 中連接一台 Linux 伺服器，再開啟 Open WebUI 範本，選擇伺服器並部署。

目前範本的設定如下：

設定	值或用途
映像檔	ghcr.io/open-webui/open-webui:main
HTTP 連接埠	8080
持久化目錄	/app/backend/data，SQLite 資料庫、上傳文件和設定都在這裡
WEBUI_SECRET_KEY	專案建立時自動產生，用於加密登入工作階段
ENABLE_OLLAMA_API	false，預設關閉本機 Ollama 探測，直接使用外部 API
遙測變數	預設關閉 SCARF_NO_ANALYTICS、DO_NOT_TRACK 與 ANONYMIZED_TELEMETRY
記憶體	建議預留 2 GB

main 標籤會隨上游更新。打算長期穩定使用時，在服務 設定 的 來源 中把映像檔改成你驗證過的固定版本（例如 ghcr.io/open-webui/open-webui:v0.6.5）。

綁定網域，立刻註冊管理員帳號

在 open-webui 服務的 網路 頁為 8080 連接埠綁定網域，例如 chat.example.com，在 DNS 新增指向伺服器的 A 記錄，等待 HTTPS 生效。步驟見網域文件。

網域一生效就馬上開啟網站註冊第一個帳號。 Open WebUI 會把第一個註冊的人設為管理員；在你完成註冊之前，任何知道這個網址的人都能搶先註冊成管理員。

註冊登入後，開啟 管理員面板 → 設定 → 一般（Admin Panel → Settings → General），檢查新使用者註冊策略：

• 只給自己用：關閉新使用者註冊（停用 Sign Up）；
• 給團隊用：把預設使用者角色設為「待審核（pending）」，只有你核准過的帳號才能使用模型。

串接模型介面

開啟 管理員面板 → 設定 → 外部連線（Connections），在 OpenAI API 一欄填入模型服務商的 Base URL 和 API Key，儲存後即可在聊天頁左上角看到模型清單。

常見接法：

• 直連官方或相容介面：填入服務商提供的 OpenAI 相容網址（通常以 /v1 結尾，注意不要重複拼兩次 /v1）與對應的 API Key。
• 透過自架閘道串接：如果你部署了 New API、Magpie 或 LiteLLM，可以把 Base URL 指向你的閘道網址，用一個閘道統一管理 OpenAI、Anthropic、Gemini、DeepSeek 等多家渠道與額度。若閘道與 Open WebUI 在同一個 Zenavo 專案裡，還可以直接走內網網址（例如 http://new-api.zenavo.internal:3000/v1）。
• 加上免費聯網搜尋與通訊軟體入口：想讓模型檢索即時網頁，可以在同一個專案裡加入自架的 SearXNG 元搜尋引擎；想從 Telegram、Discord 或 Slack 隨時呼叫 AI 助理，還可以搭配 OpenClaw。

如果有多位成員共用，可以在管理員的模型設定裡控制哪些模型對一般使用者可見，避免大家誤用昂貴的模型。

備份與升級

Open WebUI 的帳號、聊天紀錄、知識庫檔案與後台連線設定都儲存在 /app/backend/data 磁碟區裡。同時，服務 變數 裡的 WEBUI_SECRET_KEY 用於保護工作階段，部署後不要隨意更改，並建議複製一份存好。

在 open-webui 服務的 備份與還原 中備份磁碟區：

1. 挑一個沒有人在使用的維護時段，停止專案（磁碟區備份需要專案處於停止狀態）。
2. 建立備份，完成後重新啟動專案。
3. 下載一份備份自行保存。備份裡包含聊天紀錄與填入的 API Key，請妥善保管。

操作細節見備份與還原。升級前先備份磁碟區，讀完 Open WebUI 的發行說明再修改映像檔標籤。大版本升級可能會遷移內部資料庫結構，萬一升級出錯，用升級前的備份還原最穩妥。

常見問題

儲存連線後模型清單是空的？ 檢查 Base URL 是否以服務商要求的路徑結尾（多數 OpenAI 相容介面需要帶 /v1），以及 API Key 是否有效。有些相容介面不支援列出模型（/v1/models），可以在連線設定裡手動填寫要用的模型 ID。

呼叫模型時出現 401 或 404？ 401 通常是 API Key 填錯、過期或沒有該模型權限；404 多半是 Base URL 多寫了 /chat/completions 或漏寫了 /v1。

改了環境變數，重新啟動後頁面設定沒變？ Open WebUI 把許多管理端設定寫入資料庫後，資料庫裡的設定會優先於環境變數。需要調整時，直接在網頁的 管理員面板 → 設定 裡修改並儲存。

能接本機 Ollama 嗎？ 可以，但範本預設設了 ENABLE_OLLAMA_API=false，避免沒裝 Ollama 時後台一直報錯。如果你在同一專案或同一內網跑了 Ollama，把 ENABLE_OLLAMA_API 改為 true 並填寫 OLLAMA_BASE_URL 即可。

從 Open WebUI 範本開始：先綁定網域、搶先註冊管理員並收緊註冊權限，再串接模型介面、安排好磁碟區備份。