Skip to main content
Open WebUI 是一個功能開源的 AI 互動介面，支援多種模型服務商接入，提供使用者管理、對話記錄持久化等能力。本指南介紹如何透過 Docker Compose 部署 Open WebUI，並接入 MixRoute 統一呼叫各類主流 AI 模型。

​
部署前準備

1

準備 MixRoute 憑證

  1. 取得 MixRoute API 端點地址：https://api.mixroute.ai/v1
  2. 在 MixRoute 控制台生成您的 API Key。
  3. 確認需要使用的模型名稱，如 gpt-5.5（需在 MixRoute 控制台已啟用該模型）。
2

環境依賴檢查

確認電腦或伺服器已安裝 Docker（包含 Docker Compose V2）。在終端執行：
如果兩條命令都能回傳版本號，說明環境已就緒。如未安裝，請前往 Docker 官網 下載安裝 Docker Desktop（Windows/macOS）或 Docker Engine（Linux），安裝完成後重新執行上述命令確認。
較早版本的 Docker Compose 使用 docker-compose（中間有短橫線）的寫法，本手冊統一使用新版語法 docker compose（中間是空格）。

​
部署 OpenWebUI

​
1. 建立專用資料夾

打開終端，執行以下命令（建立名為 openwebui 的資料夾並進入）：

​
2. 建立 docker-compose.yml

在 openwebui 資料夾內新建 docker-compose.yml，內容完整複製貼上如下：
欄位說明：
如果需要在伺服器或區域網路環境中使用 Open WebUI，可透過環境變數新增 WEBUI_SECRET_KEY 和 WEBUI_URL：
  • WEBUI_SECRET_KEY：可使用 openssl rand -hex 32 隨機生成。
  • WEBUI_URL：填入公網 IP 或網域。
如果本機 3000 埠已被佔用，可把 "3000:8080" 改為例如 "3010:8080"，存取地址相應改為 http://localhost:3010。

​
3. 啟動服務

在 docker-compose.yml 所在目錄下執行：
  • up：啟動服務
  • -d：背景執行
首次執行會自動下載映像檔，根據網路情況需要等待幾分鐘。看到類似 Container open-webui Started 的提示，說明啟動成功。 檢查執行狀態：
如果 STATUS 欄顯示 Up，說明服務正在正常執行。

​
存取並初始化帳號

1

存取 Web 介面

打開瀏覽器存取 http://localhost:3000。如果部署在遠端伺服器上，把 localhost 換成伺服器 IP 地址，例如 http://伺服器IP:3000。
2

註冊首個帳號

第一次打開會看到註冊頁面，請填寫資訊完成註冊。
第一個註冊的帳號會自動成為**管理員（Administrator）**帳號，擁有使用者管理和系統設定權限，請務必牢記這個帳號的郵箱和密碼。
3

後續使用者審批

之後如果有其他人註冊，新帳號預設是「待審批（Pending）」狀態，需要管理員登入後台手動批准才能使用。

​
接入 MixRoute

Open WebUI 本身只是一個互動介面，需要連接至少一個模型服務商才能進行對話。Open WebUI 支援多種模型來源： 推薦透過 MixRoute 統一接入，一次設定即可使用 200+ 主流 AI 模型，並在便捷使用的同時提供足夠的隱私保護等級。
1

打開設定

登入 Open WebUI 後，點擊左下角頭像 →「設定」（Settings）。Openwebui P1
2

進入連接配置

進入「管理員設定」（Admin Settings）→「連接」（Connections）。Openwebui P2
3

填寫 MixRoute 憑證

根據要接入的服務商，填寫對應的 API 地址（Base URL） 和 API Key，儲存即可。
  • Base URL：https://api.mixroute.ai/v1
  • API Key：填入您的 MixRoute API Key（例如 sk-xxxxxxxx） Openwebui P3
4

選擇模型並開始對話

返回主介面，在模型選擇框中就能看到新接入的模型，選中後即可開始對話。
經過測試，GPT 系列在 OpenWebUI 中表現良好，建議配合 GPT 模型使用。

​
常用維護操作

​
停止服務

​
重新啟動服務

​
檢視日誌（排查問題用）

​
更新到最新版本

pull 會拉取最新映像檔，up -d 會用新映像檔重新建立容器，資料不會遺失（因為資料儲存在 volumes 中，與容器本身分離）。

​
徹底解除安裝

僅停止並刪除容器（保留資料，可隨時重新 up -d 恢復）：
停止並刪除容器 同時刪除全部資料（聊天記錄、帳號等將永久遺失，謹慎操作）：

​
常見問題

  • 確認容器是否正常執行：docker compose ps，檢視 STATUS 是否為 Up。
  • 確認埠是否被其他程式佔用，可嘗試修改 docker-compose.yml 中的埠號後重新 docker compose up -d。
可以在設定中重設密碼；如無法登入，需透過資料庫層面處理，建議先在 Discord/GitHub 社群尋求協助，避免直接刪除資料卷（會遺失全部資料）。
修改儲存檔案後，在同一目錄下重新執行：
Docker Compose 會自動檢測變化並重建容器。
配置完成後，Open WebUI 所有的對話與能力都將基於您在設定中綁定的 MixRoute 端點進行驅動，享受強大且極具性價比的雲端大模型服務。