Home Assistant 升級不再心驚膽跳：備份、驗證、升級、回滾的完整流程

charles

這篇的內容（6 段）

1. 7-1 看有沒有整合壞掉
2. 7-2 看有沒有新的錯誤
3. 7-3 看有沒有實體變成不可用
4. 7-4 實際動一次
5. 7-5 修復項目
6. 路二：指定版本重裝 Core

升級 Home Assistant 會不會出事，不取決於你按不按更新，取決於出事那一刻你手上有沒有一份「證明還原得回來」的備份。這一篇把整套流程一步一步做完，每一步都告訴你螢幕上該出現什麼。



先講一件很多人不知道的事：Home Assistant 的備份系統在 2025.1 整套重做過。現在的備份預設是加密的，而解密要用一把加密金鑰。官方文件寫得很直白 —— 這把金鑰不會存在 Nabu Casa 那邊，沒有金鑰就沒有任何方法打開那個檔案。

也就是說：如果你是 2025 年以前設定的 HA，而且從來沒有下載過「緊急工具包」，那你現在手上那些備份，在最需要它的那一天可能打不開。這一篇的前半段就是在處理這件事。

■ 這一篇會做完什麼

• 把自動備份設好，並把加密金鑰與緊急工具包存到 HA 以外的地方
  
• 加一個異地備份位置，讓主機整台掛掉時還有東西可以還原
  
• 實際驗證備份「打得開」，而不是只確認它「存在」
  
• 用正確的順序升級，並在升級後五分鐘內把該檢查的檢查完
  
• 出事的三條回去的路，以及各自什麼時候有效
  
• 做一個「備份失敗就通知手機」的自動化，讓靜默失敗不再靜默
  

■ 步驟 0：先確認你是哪一種安裝

後面的指令會因為安裝方式而不同，所以先確認。到 設定 → 系統 → 修復 → 右上角三個點 → 系統資訊。

你會看到一塊「版本資訊」，裡面有這幾行：

1. Core                 2026.9.3
2. Supervisor           2026.09.1
3. Operating System     16.2
4. 前端                 20260903.0

複製代碼

判讀方式：

• 有 Supervisor 和 Operating System 兩行 → 你是 Home Assistant OS（官方綠盒子、或自己灌在樹莓派／小主機上的 HAOS）。這一篇的指令你全部都能用
  
• 只有 Core 和前端，沒有 Supervisor → 你是 Container（Docker 裝的）。備份的部分要自己處理，文章後面有單獨一段
  

順帶一個 2026 年一定要知道的事：官方在 2025 年 5 月宣布，Supervised 與 Core（venv）兩種安裝方式已經棄用，並於 2025.12 結束支援。現在官方支援的只有 HA OS 與 Container 兩種。如果你的系統資訊顯示的是 Supervised，升級之前要先處理這件事，不然你會在某一版之後開始收到不再修的錯誤。

■ 步驟 1：把自動備份設起來（含加密金鑰）

到 設定 → 系統 → 備份。

如果你從來沒設定過，畫面正中央會看到一個藍色按鈕寫著 「設定自動備份」。按下去會跑一個四頁的精靈：

• 第一頁 備份內容 —— 選「建議設定」就好。它會包含 Home Assistant 的設定資料庫、所有附加元件、以及 /config 目錄
  
• 第二頁 排程與保留份數 —— 建議設定是每天凌晨備份一次、保留三份。份數不是越多越好，每一份大約 200 MB 到 2 GB，保留三份大多數人夠用
  
• 第三頁 加密金鑰 —— 這一頁是整篇文章最重要的地方
  
• 第四頁 備份位置 —— 先照預設（本機）走完，下一步再加異地
  

第三頁你會看到一串像這樣的東西（每組四個字元，共七組，實際內容每個人都不一樣）：

1. ABCD-EFGH-IJKL-MNOP-QRST-UVWX-YZ12

複製代碼

下面有一個按鈕寫著 「下載緊急工具包」。一定要按它，它會下載一個叫 home_assistant_backup_emergency_kit.txt 的檔案，裡面就是那串金鑰加上還原說明的連結。

然後做這三件事（缺一不可）：

• 把那個 txt 檔存到 HA 主機以外的地方。手機的筆記軟體、密碼管理器、隨身碟、印出來夾在路由器旁邊都可以 —— 唯一不可以的是「只留在 HA 裡」，因為 HA 掛掉的時候你就是要用它
  
• 把那串金鑰也貼進你的密碼管理器，當成一筆密碼存著
  
• 如果家裡有第二個人會動 HA，讓他也有一份
  

精靈跑完之後會立刻做第一份備份。你會看到畫面上方出現一條進度條，文字是 「正在建立備份…」，下方的狀態從 閒置 變成 建立備份中。視資料量大小，通常三到十分鐘。

完成後你會看到備份清單多一列，大致長這樣：

1. 自動備份 2026-09-25 04:45      1.2 GB      本機儲存空間

複製代碼

看不到那一列，代表備份失敗了。最常見的原因是磁碟空間不足 —— 到 設定 → 系統 → 儲存空間 看剩餘空間，備份需要的空間大約是你目前 /config 大小的兩倍。

如果你早就設定過備份，畫面不會有精靈。這時候到備份頁面右上角的三個點，選 「備份設定」，往下捲到 「加密」 那一區，按 「下載緊急工具包」，就能把金鑰重新拿出來。

以下還有約 80% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入