Open WebUI 0.13.4 把直連收進 Tether:四組舊設定升級失效

Open WebUI 於 2026 年 11 月 17 日發布 0.13.4,版本號雖是 0.13 系列的第四次更新,更新說明的 Changed 段卻有四條會讓既有設定失效:Terminals 伺服器必須升到 0.4.0 且沒有自動遷移、個人直連設定改由 Tether 桌面程式接手、圖像生成環境變數改由連線設定接管、程式代理模型 ID 重新命名。同版新增的本機 MCP 伺服器、互動圖表與影片生成工具都預設關閉。

用 AI 摘要這篇文章:

2026 年 11 月 17 日,Open WebUI 在 GitHub 發布 v0.13.4。從版號看,這只是 0.13 系列的第四次更新,距離上一次實質更新 v0.13.1 才九天,中間的 v0.13.2 與 v0.13.3 更新說明分別只有 851 與 5,698 個字元。但 v0.13.4 的更新說明有 55,920 個字元,Added 47 條、Changed 16 條、Fixed 85 條,引用的 187 個 GitHub 編號(issue、PR 與 discussion 合計)與 v0.13.1 引用的 109 個沒有任何重疊。

真正會影響既有部署的,是 Changed 段裡的四條:Terminals 伺服器必須升到 0.4.0、個人加的直連設定整併進 Tether 桌面程式、圖像生成的環境變數在首次啟動被轉成連線後不再讀取、程式代理模型的 ID 改名。更新說明的原文分別是「Terminals 0.4.0 required」「Direct connections move to Tether」「Image settings become connections」「New coding agent model IDs」。對已經在跑 0.13.1 到 0.13.3 的人來說,這一版要當成遷移版來對待,不是換個映像檔 tag 就結束。

Open WebUI v0.13.4 更新說明的 Changed 段,依序列出 Terminals 0.4.0 required、Direct connections move to Tether、Image settings become connections 等條目Pin
v0.13.4 的 Changed 段開頭四條:Terminals 得升 0.4.0、直連搬進 Tether、圖像設定變連線、代理模型 ID 改名。

四個升級斷點:誰會碰到、升級前記什麼、升級後重做什麼

四個斷點的升級前後對比見下表。

斷點誰會碰到升級前要做的事升級後要做的事
Terminals 得升 0.4.0有接 Terminals 伺服器的團隊備份 Open WebUI 與 Terminals 兩邊的資料庫、所有終端機檔案;記下每條連線的 Policy ID、image、resource、storage、idle timeout另起一個全新的 0.4.0 安裝,重建 template,把檔案複製過去,再到聊天、自動化、資料夾、模型設定重選新終端機
直連搬進 Tether自己在 Settings 加過 Ollama、LM Studio 或任何 OpenAI 相容端點、OpenAPI 工具、Open Terminal 的人抄下 Settings > Connections 與 Settings > Tools 裡每一條連線的位址與金鑰安裝 Tether 0.1.14 以上,在 Tether 的 Settings → Integrations 重新新增
圖像設定變連線用 docker-compose 或環境變數設定 IMAGE_GENERATION_ENGINE、IMAGES_OPENAI_API_BASE_URL、COMFYUI_BASE_URL 的部署記下目前生成與編輯各用哪個引擎、模型、尺寸第一次啟動會自動轉成一或兩條 image connection;之後改環境變數沒有效果,要到後台的連線設定改
代理模型 ID 改名釘選過 Codex 等程式代理、或讓自動化指向代理模型的人列出釘選清單與自動化指向的模型名稱含點號或其他字元的代理模型要重新選一次;舊對話的第一則新訊息會開一個新的代理工作階段

四條裡最重的是 Terminals。Terminals v0.4.0 在 11 月 10 日發布,更新說明開頭就是「Breaking upgrade: manual migration required」,寫明這一版改了資料庫 schema、儲存路徑與已儲存的終端機選項,而且「does not provide automatic migration」。它同時寫著「Requires Open WebUI 0.13.4 or later」,兩邊得一起升。要退回舊版也不簡單:還原時要把 Open WebUI 資料庫與設定一起還原到遷移前的版本,再跑舊的 Terminals 與 Open WebUI,官方寫明「Reverting the image alone cannot undo a migration」。

Terminals v0.4.0 更新說明頂端的警告框,寫明 Breaking upgrade: manual migration required 與 Requires Open WebUI 0.13.4 or laterPin
Terminals 0.4.0 的警告框:既有安裝不能只換映像檔,這一版改了資料庫 schema、儲存路徑與已儲存的終端機選項,沒有自動遷移。

Open WebUI 這邊則是把 Terminals 連線原本在 Admin Settings > Integrations 的 Policy ID、image、resource、storage、idle timeout、Terminal Contexts 欄位與 Refresh Terminals 按鈕全部拿掉,改由 Terminals 0.4.0 的 template 接管。template 把終端機設定與共享規則收在一起,每個 template 有一個 scope:None 是所有有權限的人共用一個工作區,User 是每人一個、跨聊天沿用,Chat 是每個存檔的聊天一個、允許繼續該聊天的人共用,Model 是每個模型或預設一個。官方提醒新 template 預設 None,要每個人有自己的檔案得自己選 User。容器名稱與檔案位置也改成跟著 template 與 scope 走,聊天與模型工作區不再看誰先開啟;Open WebUI 改用 Terminals 伺服器金鑰連線,Terminals 設定裡的 TERMINALS_OPEN_WEBUI_URL 與 TERMINALS_TOKEN_CACHE_TTL 要移除。

直連那一條影響的可能是最多人。過去在 Settings > Connections 填一個 Ollama 位址就能把本機模型接進來,這是自架 Open WebUI 常見的起手式,也是接 Ollama 相容介面的通用做法。v0.13.4 之後,Settings > Connections 與 Settings > Tools 兩頁消失,Admin Settings 裡的 Direct Connections 與 Direct Integrations 兩個開關、Direct Tool Servers 權限也一起拿掉,使用者自己加的模型、工具伺服器與終端機「不再出現」。官方給的替代路徑是 Tether app。

Tether 接手直連:金鑰留在自己電腦,代價是設定要搬兩次

Tether 是 open-webui 組織下的桌面程式,倉庫描述只有一句:「The desktop companion for Open WebUI」。它裝在使用者自己的電腦上,把那台電腦上的 Ollama、LM Studio、其他 OpenAI 相容模型伺服器、OpenAPI 工具與 Open Terminal 伺服器登記成連線,再提供給任何一個你連上的 Open WebUI。金鑰存在自己電腦,不進 Open WebUI 伺服器。

Tether 在 v0.13.1 那一版首次登場,當時是選項。v0.13.4 把它變成個人連線的唯一入口,同時把功能往前推了三步:模型、工具、終端機只要你在 Tether 加過,從任何裝置打開任何 Open WebUI 都看得到,位址、指令與金鑰留在自己電腦(Tether 0.1.14 以上,工具伺服器與終端機還要開 ENABLE_TOOL_SERVERS);本機用 stdio 跑的 MCP 伺服器可以直接掛上來,不需要 mcpo 這類代理,也不用開 port(Tether 0.1.16 以上);Tether 0.1.13 以上的沙箱可以把 Open Terminal 鎖在你選的那個資料夾,預設離線執行(可手動開啟 Network access),沙箱無法落實時終端機就停著不跑。要注意這個 repo 在 2026 年 10 月 31 日才建立,0.13.4 發布時它才 17 天。

Open WebUI 更新說明沒寫、只記在 Tether 自己 release 裡的一個細節:Tether v0.1.16 在 11 月 16 日重整了設定版面,更新說明的 Changed 段寫著「Previously saved integrations must be added again」,0.1.14 或 0.1.15 在 Settings → Integrations 存的模型、工具、終端機連線「are not carried over to the new settings layout」,並要求使用者升級前先記下位址與金鑰。從 Open WebUI 直連搬到 Tether 是第一層搬遷,Tether 自己從 0.1.15 到 0.1.16 又是第二層。如果有人在 11 月 13 日到 15 日之間先裝了 Tether 0.1.14(它本身就要求 Open WebUI 0.13.4 以上,當時只有預發布版能配),把連線都打好,11 月 16 日更新到 0.1.16 之後那些連線也都要重打一遍。0.1.16 的新版面把新增與編輯連線改成獨立對話框,有 Save 與 Cancel,金鑰留白就是保留;存檔一條 MCP 連線會關掉它現有的工作階段,下次使用才重連。

Tether v0.1.16 更新說明的 Changed 段,第二條寫明 Previously saved integrations must be added againPin
Tether 0.1.16 的 Changed 段:0.1.14 或 0.1.15 存的連線不會帶到新版面,升級前要先記下位址與金鑰。

三個 repo 的版本要一起對齊:Open WebUI 0.13.4 配 Tether 0.1.14 起跳,要本機 MCP 就要 0.1.16;Terminals 要 0.4.0,Start 與 Stop 要 0.4.1(目前最新 0.4.4,11 月 19 日);Open Terminal 的新代理與 Claude Code、Grok 的 Auto 核可要 0.17.19,終端機上傳的多使用者權限修正要 0.17.20,start directory 與 setup script 要 0.17.7。

後端設定檔的變化:三個開關歸零、lock 檔第一次出現、遷移函數只跑一次

更新說明寫「設定消失」,後端設定檔也對得上。v0.13.1 與 v0.13.4 兩個 tag 的 backend/open_webui/config.py 裡,ENABLE_DIRECT_CONNECTIONS 從 2 處變 0 處,ENABLE_DIRECT_INTEGRATIONS 從 2 處變 0 處,USER_PERMISSIONS_FEATURES_DIRECT_TOOL_SERVERS 從 3 處變 0 處,與更新說明列出的三個被移除的設定一字不差。同時 VISUALIZATION_PROMPT_TEMPLATE 從 0 處變 2 處,對應本版新增的互動圖表工具。

Docker 相關的三個檔案也是這一版才有的:backend/update-locks.sh 與它產生的 backend/requirements.lock、backend/requirements-slim.lock,在 v0.13.1 的 tag 都還不存在,到 v0.13.4 才有。requirements.lock 有 7,674 行,每個套件都帶 --hash=sha256:,符合更新說明「標準與 slim 映像檔除 PyTorch 外全部從 lock 檔安裝」的描述。實際影響落在自己 build 映像檔的部署:以後改 backend/requirements.txt 加套件,不跑 update-locks.sh 重新產生 lock,改動不會生效。

圖像設定那一條的機制藏在 backend/open_webui/utils/images/connections.py 第 505 行的 migrate_legacy_image_config()。這個函數由 main.py 第 398 行在啟動時呼叫,docstring 寫得很清楚:connections 這個設定鍵「只在這裡或管理員寫入,所以它不存在就代表這個部署還沒遷移」。函數讀的是 image_generation.enable、image_generation.engine、image_generation.model、image_generation.openai.api_base_url、image_generation.openai.api_key 等 32 個持久化設定鍵。生成與編輯如果用同一個後端、同一組位址與金鑰,會併成一條同時具備生成與編輯能力的連線,編輯模型不同的話追加到模型清單;後端不同就拆成兩條,編輯那條名稱加上「(edit)」。轉出來的連線開放給所有使用者,對應更新說明的「之前能用的人繼續能用」。ComfyUI 與 AUTOMATIC1111 這類沒有模型名稱的引擎,連線的預設模型會留空。

這也解釋了為什麼 IMAGE_GENERATION_ENGINE 在 v0.13.4 的 config.py 第 1356 行還在,更新說明卻說它「不再讀取」。Open WebUI 的持久化設定只在資料庫還是空的時候拿環境變數當初始值,之後都讀資料庫;遷移把資料庫裡的圖像設定轉成連線以後,環境變數自然沒有作用。想讓環境變數重新接管,更新說明給的唯一開關是關掉 ENABLE_PERSISTENT_CONFIG。

三項主打新功能都預設關:開關分別在哪裡

Added 段 47 條裡的三項主打功能,裝好之後都看不到,因為都預設關閉。

互動圖表(Interactive visualizations):模型可以在聊天裡畫互動圖表、計算機、解說頁,靠的是新的 Visualizations 內建工具。更新說明寫它「off by default」,要依模型在 Builtin Tools 打開;管理員可以在 Admin Settings > Interface > Visualization Prompt 或用 VISUALIZATION_PROMPT_TEMPLATE 改寫它的指示。

影片生成(Video generation):管理員要先在 Admin Settings > Videos 打開,接 OpenAI、LiteLLM 或 OpenRouter 的連線(更新說明點名 Veo 與 Kling),設預設影片模型與存取設定,再開 Video Generation 權限,這個權限一樣預設關。使用者在 + 選單開 Video,可以從聊天裡的一張圖開始生成。

本機 MCP(Local MCP servers through Tether):更新說明寫 Open WebUI 現在可以用 stdio 本機指令跑的 MCP 伺服器,由 Tether 0.1.16 以上在自己的電腦啟動,不需要 mcpo 也不用開 port;Tether 的 v0.1.16 更新說明補了一句,新的工具連線預設 Streamable HTTP 而且「stay off until you enable them」。本機指令是以使用者自己的帳號權限執行、在 Tether 工作區沙箱之外,評估要不要把 MCP 交給本機跑時要把這點算進去。

程式代理那一條嚴格說與預設關無關,是版本地板的問題。更新說明寫 Hermes、Antigravity、GitHub Copilot、Goose、Qwen Code 加入 Codex、Claude Code、Cursor、Grok、OpenCode、Cline、Gemini CLI、Pi 的行列,在聊天裡像一般模型一樣選;但新代理與 Claude Code、Grok 的 Auto 核可需要 Open Terminal 0.17.19 以上,而 Open Terminal 的 v0.17.19(11 月 16 日)更新說明同樣寫著「Requires an updated Open WebUI」。Claude Code 從中間續談則要等 0.17.20 之後的版本,Open Terminal v0.17.21 在 11 月 21 日補上這一項。

其他會讓教學文件跟著名稱改的變動

Changed 段剩下的十幾條,不少是改名與搬位置,但寫自訂客戶端或維護內部教學的人會碰到:筆記、留言、收件匣、存取變更的即時更新事件,現在全走主 events 頻道的型別訊息,聽 events:note 這類舊事件名的客戶端要改;API 的聊天回應新增 write_access 欄位,原本用 share_mode 判斷能不能回覆的客戶端要換;新的終端機連線 Chat Uploads 預設改成 Filesystem,聊天附加檔案存進選定的終端機工作資料夾,透過 Tether 接的電腦一律用這個模式,既有的連線保留原設定。

介面部分,Overview、Artifacts、Comments 從聊天的選單搬到分頁列的 + 選單,Overview 改在聊天旁邊的分頁開,不再是全螢幕視窗;訊息輸入框 + 選單裡的 Add Context 更名 Attachments;模型編輯器的 Capabilities 更名 Features;知識庫在挑選器裡從 Collection 改叫 Knowledge 或 Knowledge Base,內部搜尋框改叫 Search Files。

一般使用者會直接感覺到的是另外幾條 Added。筆記、頻道、工作區、自動化、行事曆、Playground 與釘選模型開的新聊天,現在都在目前聊天旁邊開成分頁,從側欄資料夾開新聊天時分頁也留著。回應還在跑的時候再送一則訊息,訊息會在伺服器排隊,離開頁面也不會掉,回應在下一步收尾、先回答剛送的訊息。新聊天的第一則訊息立刻顯示,不等聊天建立完成,檔案還在上傳時除外。側邊聊天現在跑的是與主畫面相同的聊天,訊息按鈕、來源、token 用量、slash 指令、程式碼執行等多項功能在側邊也能用。每個聊天會記住自己的終端機與工作資料夾,重開時切回去;舊版的聊天打開時沒有終端機,程式代理聊天除外。資料夾頁面新增聊天看板,可依狀態、標籤或活動分欄,資料夾也能設定 Backlog、To do、In progress、Waiting、Done 這類狀態,並多了一個 Automations 區塊列出資料夾的自動化與執行紀錄。

Terminals 這邊還多了一個與 0.4.0 綁定的新功能:有 Write 權限的人可以直接從訊息輸入框的終端機選單開一台沙箱電腦,選大家共用一台,或每個使用者、每個聊天、每個模型各一台,並設定 image、CPU、記憶體、儲存空間、網路設定檔、環境變數、起始目錄與 setup script,例如 clone 一個 repo 並裝好依賴。這條同樣需要 Terminals 0.4.0,Start 與 Stop 要 0.4.1,起始目錄與 setup script 要映像檔裡的 Open Terminal 0.17.7 以上。

還沒確定的部分,與會改變做法的後續動態

更新說明 Added 段有一群「Faster」開頭的條目:大型 PDF 預覽更快、資料夾重開更快、Redis 加速模型清單。這些是官方宣稱:資料夾重開與 Redis 模型清單兩條沒有任何數字,PDF 那條只給了大約值(約一秒、1500 頁手冊不再超過半分鐘),三條都沒有寫測試環境與方法。

Terminals 0.3.x 到 0.4.0 的手動遷移,官方給了八個步驟,從記錄 policy、停寫入、備份兩個資料庫,到另起新安裝、重建 template、逐個工作區準備與複製檔案、更新已儲存的終端機選項,最後在放使用者回來前先測試。這套流程實際跑起來要花多少時間,官方沒有給任何時間估計。terminals db upgrade 指令對已有資料的舊資料庫會在第 004 號遷移動到表格前拒絕,所以它不是捷徑。

Tether 沙箱「macOS 與支援的 Windows 裝置」的支援清單,更新說明沒有列哪些 Windows 裝置算支援;Linux 並未列入。

接下來值得盯的是三件事:有沒有 0.13.5 之類的修正版把 Terminals 的遷移自動化,或讓直連設定有匯入 Tether 的工具;Tether 是否再重整一次設定版面;Open Terminal 0.17.21 的 Claude Code 續談在 Open WebUI 端是否已對應(更新說明寫「with the next Open Terminal release after 0.17.20」,0.17.21 已發布,它的說明只寫「Requires an updated Open WebUI」,沒寫 0.13.4 是否已經足夠)。任何一件成立,升級前的清單就能少做幾項。

升級前依序做的六件事

綜合四條 Changed 與兩層搬遷,升級前依序做這些事:

  • 備份 Open WebUI 的資料庫與整個 data 目錄。有接 Terminals 的,兩邊的資料庫與所有終端機檔案都要備份,只停 Terminals 服務不會停它的容器,要先停工作負載。
  • 打開 Settings > Connections 與 Settings > Tools,把每一條連線的名稱、位址、金鑰抄下來。這兩頁在 0.13.4 會消失,更新說明沒有提供匯入工具,要在 Tether 手動重加。
  • 有在用圖像生成的,記下生成與編輯各自的引擎、模型、尺寸。第一次啟動會自動轉成連線,之後只能在後台改(除非關掉 ENABLE_PERSISTENT_CONFIG)。
  • 列出釘選的程式代理模型與自動化指向的模型。名稱含點號的,升級後要重選。
  • 自己 build 映像檔的,改 backend/requirements.txt 之後要跑 backend/update-locks.sh。
  • 先裝 Tether 0.1.16 以上,再升 Open WebUI 0.13.4,然後在 Tether 的 Settings → Integrations 把前面抄下來的連線一條條加回去。

沒有自己加過連線、沒接 Terminals、沒釘選代理模型的單人部署,這一版的四條 Changed 幾乎都碰不到,直接升,再到 Admin Settings 把想要的新功能打開就好。

Sliven 褚崇名
Sliven 褚崇名

每日分享科技新知、免費資源以及 WordPress、虛擬主機相關主題,任何問題歡迎在科技月球下方留言,或是發送 Email 至 [email protected] 與我聯繫。

文章: 2629

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *


Share to...