【HA 升級】升級前先確認你的備份打得開：加密金鑰、安全模式、降級的完整流程

charles

這篇的內容（21 段）

1. 第一步：去看備份設定
2. 第三步：驗證它真的能用
3. 步驟 3：檢查設定
4. 步驟 5：挑時間
5. 步驟 6：升級
6. 步驟 7：升完的十分鐘檢查
7. 一、看修復頁
8. 三、檢查整合
9. 五、清瀏覽器快取
10. 六、實際操作一次
11. 步驟 8：壞了怎麼辦
12. 情況一：整個前端變成白畫面
13. 情況二：某個整合壞了
14. 情況三：HA 完全起不來
15. 步驟 9：降級
16. 步驟 10：四個減少痛苦的策略
17. 一、不要升 x.0
18. 二、先看別人踩了什麼
19. 三、不要落後太多
20. 四、核心與應用程式分開升
21. 這篇的驗收

Home Assistant 每個月一個大版本，升級是常態。這篇給一套不會出事的流程。

先講一件比「要備份」更重要的事：

HA 2025.1 之後的備份預設是加密的，而解密用的金鑰只會出現一次。 它在你第一次設定備份時顯示在「緊急工具包」裡，Nabu Casa 不保存它，官方也救不了你。

所以最糟的情況不是「我沒備份」，是「我有備份，但打不開」 —— 而這件事你要等到真的需要還原的那一天才會發現。

步驟 0 就是處理這個。



---

步驟 0：確認你手上有那把金鑰（現在就做，不要等到要升級）

第一步：去看備份設定

• 設定 → 系統 → 備份
  
• 右上角三個點 → 顯示加密金鑰（Show encryption key）
  

你會看到什麼：一串像 `A1B2-C3D4-E5F6-...` 的字，分成好幾組。

1. 你看到的                      要做什麼
2. ------------------------------------------------------------------
3. 一串金鑰                       抄下來，存到密碼管理器（不是存在 HA 裡）
4. 找不到那個選項                 你還沒設定過備份，按「設定備份」走一次

複製代碼

第二步：把它存到 HA 以外的地方

這一點是整篇最容易被忽略的。 把金鑰記在 HA 的待辦事項、或者寫在設定檔裡，等於沒有 —— 你需要它的時候，HA 正好是打不開的那個東西。

正確的位置（至少兩個）：

• 手機上的密碼管理器（Bitwarden、1Password、iCloud 鑰匙圈）
  
• 列印出來或手抄，跟重要文件放一起
  

第三步：驗證它真的能用

沒測過的備份不算備份。 現在就測一次：

• 設定 → 系統 → 備份 → 點任何一份備份
  
• 右上角三個點 → 下載備份
  
• 下載下來的是一個 `.tar` 檔
  

你會看到什麼：檔案大小通常在幾十 MB 到幾 GB。只有幾 KB 的話那份備份是壞的，重新建一份。

進階一點的驗證（在電腦上）：

1. tar tf backup_xxx.tar

複製代碼

你會看到什麼：一串檔名，包含 `backup.json` 和幾個 `.tar.gz`。看得到 `homeassistant.tar.gz` 就代表設定有被包進去。

---

步驟 1：看 Breaking Changes（五分鐘）

Breaking Changes 的意思是「這些東西升上去就會壞」。

在哪裡看：

• 設定 → 系統 → 更新 → 點那個版本 → 會跳出更新說明
  
• 或者去 HA 官方部落格，每個月初有一篇「20XX.X: 標題」的發布文，最下面有 Breaking Changes 那一段
  

怎麼看才有效率：不要整篇讀。用瀏覽器的 Ctrl+F 搜尋你實際在用的東西：

1. 搜尋這些關鍵字            為什麼
2. ------------------------------------------------------------------
3. 你用的整合名稱            Zigbee、Z-Wave、MQTT、UniFi、Tuya…
4. template                  範本語法變動會一次打爛很多東西
5. automation / trigger      觸發器語法變動
6. 你的品牌名                Shelly、Aqara、Xiaomi…

複製代碼

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

登入繼續閱讀使用 Google 登入