Zigbee 協調器備份與換硬體：關鍵是那組 IEEE 位址，不是三個檔案

charles

這篇的內容（16 段）

1. 第一部分：備份
2. 這個 zip 要放哪裡
3. 4-5 插上新棒子，啟動 Zigbee2MQTT
4. 5-1 ZHA 會自動備份
5. 5-2 手動備份
6. 5-3 換協調器
7. 5-4 ZHA 與 Zigbee2MQTT 互換
8. 第二部分：韌體更新
9. 6-1 重開會觸發「通電行為」
10. 6-3 你無法備份目前的韌體
11. 7-1 插電裝置：直接更新
12. 7-3 中途要停
13. 7-4 可以降版回去
14. 步驟 8：控制自動檢查的頻率
15. 9-1 HA 的自動備份
16. 9-3 備份要驗過才算數

這篇講兩件都得在出事之前做的事：怎麼正確備份，以及韌體更新的取捨。

先講結論：換協調器不用重新配對的關鍵，不是「把資料夾複製過去」，而是把舊棒子的 IEEE 位址寫進新棒子。很多教學漏掉這一步，照著做會得到一堆叫不動的裝置，而且看不出原因。



第一部分：備份

先看最壞的情況：

• 協調器 USB 棒壞了
  
• 主機掛了要重灌
  
• 想換一支更好的協調器
  

沒有備份的話 —— 五十個裝置全部要重新配對：爬梯子、按 reset、等配對、重新命名，然後所有自動化裡的實體 ID 都變了要一條一條改。

有備份的話 —— 插上去、開機、全部照舊。

---

步驟 1：先確認你的協調器支援備份還原

這一步先做，因為答案是「不支援」的話，後面全部白費。

官方明講：備份與還原只實作在 `zstack`（Texas Instruments）與 `ember`（Silicon Labs）兩種適配器上。`conbee`、`ezsp`、`zboss`、`zigate` 都不支援。

怎麼查自己是哪一種：Zigbee2MQTT 前端 → Settings → About，看 Coordinator 那一區的 type，或直接看 `configuration.yaml` 的：

1. serial:
2.   port: /dev/serial/by-id/usb-...
3.   adapter: zstack        # 或 ember

複製代碼

你會看到：About 頁會列出 Coordinator 的 type、firmware 版本、IEEE Address。把那個 IEEE Address 抄下來或截圖 —— 第二部分會用到它，而且棒子壞掉之後你就讀不到了。

常見協調器的對應：

• zstack —— CC2652P / CC2652RB / CC1352P、SONOFF Dongle Plus（P 版）、大部分「TI 晶片」的棒子
  
• ember —— HA Connect ZBT-1（原 SkyConnect）、ZBT-2、SONOFF Dongle-E、SMLIGHT 的部分型號
  
• 不支援備份 —— ConBee / RaspBee（deconz）、舊的 deCONZ 韌體
  

---

步驟 2：一鍵下載整包備份（取代舊教學的「複製三個檔案」）

Zigbee2MQTT 的前端在 2025 年底換成 WindFront 並成為預設，它把備份做成了一個按鈕。

• 導覽列 Settings → Tools 分頁
  
• 按 Request Z2m backup（讓 Z2M 產生一份新的）
  
• 再按 Download Zigbee2MQTT backup
  

你會看到：瀏覽器下載一個 `.zip`，內容是整個 data 目錄（日誌除外）。解開來應該至少有：

1. configuration.yaml          你的設定（名稱、精度、debounce、群組）
2. database.db                 裝置清單、綁定、群組、排程
3. coordinator_backup.json     協調器的網路資訊（網路金鑰、PAN ID、頻道）
4. state.json                  各裝置最後的狀態
5. secret.yaml                 （如果你有用）

複製代碼

zip 只有幾 KB 而且裡面沒有 coordinator_backup.json → 你的協調器不支援備份（回步驟 1）。

也可以用 MQTT 觸發（想寫進自動化的話）：發到 `zigbee2mqtt/bridge/request/backup`，酬載是空物件 `{}`，回應會是 `{"data":{"zip":"<一長串 base64>"},"status":"ok"}`。

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

登入繼續閱讀使用 Google 登入