官方於 2026 年 11 月 3 日發布 Open WebUI v0.13.0，而官方版本說明指出本次升級包含資料庫遷移。[升級判斷：適合在完成備份、確認回退方式後更新；不適合直接替換映像檔就當作完成。]若你使用多個執行個體或多個 Worker，必須依官方要求同步更新所有執行個體，再逐項驗收；也要先確認團隊能接受介面與工具呼叫、子 Agent 預設行為的變化。官方版本說明
適合你：維護單一 Open WebUI 部署、需要安排備份與驗收的開發者。
也適合你：負責多執行個體或多 Worker 更新、需協調更新窗口的運維人員。
請先評估：團隊依賴終端、工具或子 Agent 工作流程，且不能接受未測試的行為變化時。
最後更新於 2026 年 11 月 7 日；版本發布與升級事項核對自官方發布記錄、官方更新指南及官方版本說明。發布前仍應重新檢查官方資料是否有補丁或更正。
升級前：核對版本差異與部署範圍
不要把升級當成單純換映像檔。官方發布記錄確認 v0.13.0 涉及資料庫遷移；官方更新說明也要求多執行個體、多 Worker 部署同步更新所有執行個體，並在開始前備份。官方更新指南是操作依據，不能以單一容器的經驗取代你的部署核對。
先記下目前執行的版本、部署方式、映像檔標籤、執行個體與 Worker 配置，以及資料庫實際位置。若由 Docker Compose 管理，可先檢視展開後的設定：
docker compose config > compose.rendered.yaml
docker compose config 會解析並輸出 Compose 設定，適合用來檢查部署設定；Docker Compose config 說明亦有列出其用途。展開後的檔案可能包含已代入的敏感值，請限制讀取權限，不要直接附在公開工單或提交至程式碼儲存庫。
接著依官方發布記錄核對本次變更，不要只看介面是否能開啟。v0.13.0 的版本說明涉及控制按鈕位置、工具呼叫輪次上限，以及子 Agent 限制的預設行為；若團隊流程依賴這些功能，應在升級前確認新版說明與現行設定，再安排測試。
升級前：備份資料並準備回退
Open WebUI 自託管環境的資料位置會受部署方式與設定影響，不能假定所有安裝都使用相同目錄或同一種資料庫。請按實際設定盤點下列內容：
- 資料庫：確認資料庫類型、位置及備份方法；若使用外部資料庫，依該資料庫的工具與程序備份。
- 持久化資料：依目前掛載與設定，找出需要保留的使用者資料、上傳檔案或其他持久化內容。
- 設定與金鑰：記錄重要環境變數、服務連線設定及必要憑證；敏感資料應放在受控位置。
- 部署狀態：記下目前映像檔標籤、Compose 設定與執行狀態，讓你能比對變更前後差異。
資料庫與檔案資料應按部署情況協調備份；只複製一份設定檔，不代表可還原服務資料。官方提供手動資料庫遷移排障文件，可用來了解遷移相關處理方式，但不能取代你對實際資料庫的備份和還原演練。
開始更新前，至少確認備份檔案可讀、必要設定已保存，並把回退條件寫清楚：如果遷移報錯、核心資料無法讀取，或主要工作流程失效，就先停止後續變更，依部署方式還原，而不是繼續重啟或手動修改資料庫。備份與回退需由你依自己的部署管理；不要把伺服器租用等同於已包含快照或備份服務。
升級執行：依部署方式同步更新
若你使用 Docker 或 Docker Compose：依官方更新指南核對對應步驟與目標映像檔，再更新部署設定。不要照抄其他版本或其他人的命令；先確認你修改的是實際生效的設定，並保留升級前的映像檔標籤和設定紀錄。
若你使用 Python 等其他部署方式：按官方更新指南中對應的部署方式操作，確認環境、更新步驟與執行程序符合目前安裝狀況。不要把 Docker 的流程直接套用到另一種部署方式。
多執行個體或多 Worker 部署，依官方要求在同一更新安排中同步更新所有執行個體。更新期間逐一記錄映像檔或程式版本、啟動狀況、遷移訊息及異常日誌；發現資料庫遷移失敗或實例狀態不一致，就暫停擴大變更範圍，先依回退方案判斷。官方擴充部署說明可協助你核對多執行個體架構，但不能代替版本更新指南。
升級後：遷移與團隊工作流程驗收
服務程序啟動或登入頁可用，並不足以證明升級完成。請用實際帳號檢查資料是否延續，並按團隊啟用的功能驗收：
- 確認服務啟動狀態正常，並檢查記錄中資料庫遷移是否完成、有無錯誤。
- 驗證登入、歷史對話、知識庫資料與必要設定是否可用；不要只確認首頁載入成功。
- 測試模型連線、工具呼叫、終端或其他團隊實際使用的工作區操作；未啟用的功能不必為升級額外開放。
- 將驗收結果與升級前記錄比較，確認執行個體使用相同版本、設定一致，且核心流程可重現。
工具呼叫與子 Agent 的變化，請按 v0.13.0 官方說明核對具體行為；不要自行推測數值或沿用其他版本的操作文件。若你需要調整環境變數，先對照官方環境變數參考確認名稱與用途，並保留原有設定以便回退。
配置決策：依驗收結果調整，而非猜測門檻
Open WebUI 應用服務與模型推理服務不是同一項負載。升級後先觀察實際的 CPU、記憶體、儲存與網路使用情況，再判斷是否需要調整伺服器；不要只因版本號變更，就推導最低配置、並行能力或效能承諾。若模型由外部服務提供，應分開核對應用服務與模型連線的需求；若模型在自有主機執行，則須將推理負載納入同一份資源評估。
可按以下條件作決策：
- 若資料庫遷移完成、核心流程通過，且資源監測沒有顯示持續瓶頸：維持目前部署，記錄驗收結果與回退所需資料。
- 若只有特定功能失常或環境變數差異：先比對版本說明、日誌與官方環境變數參考，不要同時更換伺服器與應用設定，以免增加排查變因。
- 若服務在穩定運作後仍反覆受 CPU、記憶體或硬碟資源限制：再按實際監測資料評估是否需要更換伺服器方案。整理伺服器記憶體與硬碟選項時，應將資料庫與其他持久化資料的空間需求一併計入。
- 若你正在規劃自己的部署環境：先核對實際可選方案與系統，再決定是否遷移；需要管理 Linux 主機時，可先了解伺服器 SSH 存取方式。
若你的 Open WebUI、資料庫與模型服務在升級後能穩定運作，且現有伺服器沒有持續的資源瓶頸，就沒有必要只為了版本更新而換機。相反地，若共享雲端方案存在鄰居搶用資源、CPU 資源分配不透明，或你無法依工作負載管理硬碟與系統，評估 OSFP Cloud 的 AMD 獨立伺服器會更合適：整機由你獨享，資料留在自己的機器上。是否適合仍應以你實際的監測紀錄、部署需求及本站當前可選配置為準，可先查看 OSFP Cloud 伺服器方案。
常見問題
Open WebUI 0.13.0 應該怎麼安排升級？
先核對目前版本、部署方式、執行個體與 Worker 配置，再備份資料庫、持久化資料及必要設定。依官方更新指南執行，確認所有執行個體同步到目標版本，並完成遷移、登入和團隊工作流程測試後，才將更新視為完成。
升級 Open WebUI 前，哪些資料要先備份？
依你的部署實際使用的資料庫、持久化目錄和設定項目逐一盤點，不要假設每套安裝都使用相同路徑。另存目前映像檔標籤、重要環境變數與運行狀態；備份完成後確認檔案可讀，並預先寫明如何還原及何時停止升級。
Open WebUI 有多個執行個體時，可以分批更新嗎？
官方升級說明要求多執行個體或多 Worker 部署同步更新所有執行個體。不要讓新舊版本長時間混跑；安排同一更新窗口，先確認每個執行個體的映像檔與設定，再觀察遷移結果及日誌，異常時停止擴大變更。
升級後工具呼叫和子 Agent 的設定要重查嗎？
要。官方版本說明列出控制按鈕位置、工具呼叫輪次上限及子 Agent 限制預設行為的變化。逐項對照該版本的發布說明，再用團隊實際啟用的工具與工作流程測試；不要把預設行為或設定值推廣成其他版本也相同。
常見問題
Open WebUI 0.13.0 應該怎麼安排升級？
先核對目前版本、部署方式、執行個體與 Worker 配置，再備份資料庫、持久化資料及必要設定。依官方更新指南執行，確認所有執行個體同步到目標版本，並完成遷移、登入和團隊工作流程測試後，才將更新視為完成。
升級 Open WebUI 前，哪些資料要先備份？
依你的部署實際使用的資料庫、持久化目錄和設定項目逐一盤點，不要假設每套安裝都使用相同路徑。另存目前映像檔標籤、重要環境變數與運行狀態；備份完成後確認檔案可讀，並預先寫明如何還原及何時停止升級。
Open WebUI 有多個執行個體時，可以分批更新嗎？
官方升級說明要求多執行個體或多 Worker 部署同步更新所有執行個體。不要讓新舊版本長時間混跑；安排同一更新窗口，先確認每個執行個體的映像檔與設定，再觀察遷移結果及日誌，異常時停止擴大變更。
升級後工具呼叫和子 Agent 的設定要重查嗎？
要。官方版本說明列出控制按鈕位置、工具呼叫輪次上限及子 Agent 限制預設行為的變化。逐項對照該版本的發布說明，再用團隊實際啟用的工具與工作流程測試；不要把預設行為或設定值推廣成其他版本也相同。