--- title: "架設自己的 Open WebUI：串接模型、管理帳號與保存對話" description: "用 Zenavo 的範本部署 Open WebUI，連接 OpenAI 相容模型介面，完成管理員註冊與存取控制，並做好磁碟區備份與升級。" date: 2026-11-10 language: zh-TW url: https://zenavo.app/zh-TW/blog/self-host-open-webui --- # 架設自己的 Open WebUI：串接模型、管理帳號與保存對話 如果你手邊已經有各家大型模型的 API Key，想架一個屬於自己或小團隊的網頁聊天入口，[Open WebUI](https://openwebui.com) 是最省心的單容器方案之一：內建多使用者帳號、對話紀錄、知識庫文件與模型切換，裝好就能用。 本文用 Zenavo 的 Open WebUI 範本，把介面部署到你自己的伺服器上，再串接外部模型 API。如果你想對比包含 PostgreSQL、Redis 與獨立 S3 儲存空間的多人工作台，也可以參考 [LobeHub 部署指南](https://zenavo.app/zh-TW/blog/self-host-lobehub)。 範本本身不包含本機模型或 GPU 推論；伺服器、Zenavo 平台與上游模型 API 分別計費。 ## 部署 Open WebUI 先在 Zenavo 中[連接一台 Linux 伺服器](https://docs.zenavo.app/zh-TW/servers/add-a-server)，再開啟 [Open WebUI 範本](https://zenavo.app/deploy?template=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 生效。步驟見[網域文件](https://docs.zenavo.app/zh-TW/networking/domains)。 **網域一生效就馬上開啟網站註冊第一個帳號。** Open WebUI 會把第一個註冊的人設為管理員；在你完成註冊之前，任何知道這個網址的人都能搶先註冊成管理員。 註冊登入後，開啟 **管理員面板 → 設定 → 一般（Admin Panel → Settings → General）**，檢查新使用者註冊策略： - 只給自己用：關閉新使用者註冊（停用 Sign Up）； - 給團隊用：把預設使用者角色設為「待審核（pending）」，只有你核准過的帳號才能使用模型。 ## 串接模型介面 開啟 **管理員面板 → 設定 → 外部連線（Connections）**，在 OpenAI API 一欄填入模型服務商的 Base URL 和 API Key，儲存後即可在聊天頁左上角看到模型清單。 常見接法： - **直連官方或相容介面**：填入服務商提供的 OpenAI 相容網址（通常以 `/v1` 結尾，注意不要重複拼兩次 `/v1`）與對應的 API Key。 - **透過自架閘道串接**：如果你部署了 [New API](https://zenavo.app/zh-TW/blog/self-host-new-api)、[Magpie](https://zenavo.app/zh-TW/blog/self-host-magpie) 或 [LiteLLM](https://zenavo.app/zh-TW/blog/self-host-litellm)，可以把 Base URL 指向你的閘道網址，用一個閘道統一管理 OpenAI、Anthropic、Gemini、DeepSeek 等多家渠道與額度。若閘道與 Open WebUI 在同一個 Zenavo 專案裡，還可以直接走內網網址（例如 `http://new-api.zenavo.internal:3000/v1`）。 - **加上免費聯網搜尋與通訊軟體入口**：想讓模型檢索即時網頁，可以在同一個專案裡加入自架的 [SearXNG 元搜尋引擎](https://zenavo.app/zh-TW/blog/self-host-searxng)；想從 Telegram、Discord 或 Slack 隨時呼叫 AI 助理，還可以搭配 [OpenClaw](https://zenavo.app/zh-TW/blog/self-host-openclaw)。 如果有多位成員共用，可以在管理員的模型設定裡控制哪些模型對一般使用者可見，避免大家誤用昂貴的模型。 ## 備份與升級 Open WebUI 的帳號、聊天紀錄、知識庫檔案與後台連線設定都儲存在 `/app/backend/data` 磁碟區裡。同時，服務 **變數** 裡的 `WEBUI_SECRET_KEY` 用於保護工作階段，**部署後不要隨意更改**，並建議複製一份存好。 在 open-webui 服務的 **備份與還原** 中備份磁碟區： 1. 挑一個沒有人在使用的維護時段，停止專案（磁碟區備份需要專案處於停止狀態）。 2. 建立備份，完成後重新啟動專案。 3. 下載一份備份自行保存。備份裡包含聊天紀錄與填入的 API Key，請妥善保管。 操作細節見[備份與還原](https://docs.zenavo.app/zh-TW/operations/backups)。升級前先備份磁碟區，讀完 Open WebUI 的[發行說明](https://github.com/open-webui/open-webui/releases)再修改映像檔標籤。大版本升級可能會遷移內部資料庫結構，萬一升級出錯，用升級前的備份還原最穩妥。 ## 常見問題 **儲存連線後模型清單是空的？** 檢查 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 範本](https://zenavo.app/deploy?template=open-webui)開始：先綁定網域、搶先註冊管理員並收緊註冊權限，再串接模型介面、安排好磁碟區備份。