Zigbee2CUBE 备份如何恢复到 Home Assistant

Zigbee2CUBE备份

Zigbee2CUBE备份功能是为了帮助您可以快速的将iHost上添加的Zigbee设备迁移到运行在iHost硬件上的Home Assistant 中。

一、准备工作

iHost 已经添加Zigbee设备
通过TF卡启动的方式在iHost硬件中成功运行了Home Assistant（下载Home Assistant OS镜像文件）
成功访问Home Assistant Web

二、下载备份

1.下载“ zigbee2CUBE ” 文件。

在iHost 设置页中 “ Backup & Restore ” 栏，点击下载 “ Zigbee2CUBE ”（文件格式默认是 “ zigbee-{时间戳}.tar.gz ”，例如 “ zigbee-1740000000000.tar ” ）

2. 下载完成后请将文件夹解压,你将得到以下文件内容：

configuration.yaml；

coordinator_backup.json；

database.db；

state.json；

三、还原到 Zigbee2MQTT还原（注意：使用Zigbee2MQTT除安装Zigbee2MQTT Add-on外，还需要安装 “File editor ” 和 “ Mosquitto broker ” add-on）

启动HA OS。

2.安装 “File editor ”Add-on

a.从左侧导航中栏选择 “ Settings ” ，在右侧设置项列表中找到 “ Add-ons ” 并点击进入；

b.搜索 “ File editor” Add-on；
点击右下角 “ ADD-ON STORE ” 按钮，进入 “ ADD-ON STORE ” 页面，在上方搜索区通过搜索找到 “ File editor ” Add-on 并点击它，进入 “ Info ” 页面。

c.安装并运行 “ File editor ” Add-on；
点击 “ INSTALL ”，并等待 “ File editor ” Add-on安装完成后，点击 “ START ” 等待运行成功；

d.启用侧边栏；

为了便于使用，打开 “ Show in sidebar ” 按钮，打开后会在左侧导航栏中新增出现一列 “ File editor ” 栏（后续会使用到）；

3.安装 “ Mosquitto broker ” Add-on；

a.从左侧导航中栏选择 “ Settings ” ，在右侧设置项列表中找到 “ Add-ons ” 并点击进入；

b.搜索 “ Mosquitto broker ” Add-on；
点击右下角 “ ADD-ON STORE ” 按钮，进入ADD-ON STORE页面，在上方搜索区通过搜索找到并点击 “ Mosquitto broker ” Add-on，进入 “ Info ”页面。

c.安装 “ Mosquitto broker ” Add-on；
点击 “ INSTALL ”，并等待 “ Mosquitto broker ” Add-on安装完成；

d. 配置 “ Mosquitto broker” Add-on 的Broker账号；

打开 “ Mosquitto broker ” Add-on的 “ Configuration ” 页面，在“ Options ” 栏输入Broker账号及密码后点击 “ SAVE ”，随后会弹出需要 “ Restart Mosquitto broker ” 的弹窗，点击确认等待重启成功即可；

示例：( 信息仅供参考 )
- username: amadeus

password: "1"

- username: mac

password: "1"

- username: app

password: "1"

e. 运行 “ Mosquitto broker ” Add-on；
点击 “ START ”，并等待 “ Mosquitto broker ” Add-on启动成功；

4. 安装 “ Zigbee2MQTT ” Add-on；

a. 从左侧导航中栏选择 “ Settings ” ，在右侧设置项列表中找到 “ Add-ons ” 并点击进入；

b. 搜索 “ Zigbee2MQTT ” Add-on；
点击右下角 “ ADD-ON STORE ” 按钮，进入ADD-ON STORE页面，在上方搜索区通过搜索找到并点击 “ Zigbee2MQTT ” Add-on，进入 “ Info ” 页面。

c. 安装 “ Zigbee2MQTT ” Add-on；
进入 “ Zigbee2MQTT ” Add-on的Info页面，点击 “ INSTALL ”，并等待 “ Zigbee2MQTT ” Add-on安装完成。

d. 修改“ Configuration ”，包括：

- “ socat ” 配置。（保持默认参数即可，无需改动）

配置参数（信息仅供参考）：
enabled: false

master: pty,raw,echo=0,link=/tmp/ttyZ2M,mode=777

slave: tcp-listen:8485,keepalive,nodelay,reuseaddr,keepidle=1,keepintvl=1,keepcnt=5

options: "-d -d"

log: false

- “ mqtt ” 配置。

配置参数（信息仅供参考）：
server: mqtt://core-mosquitto:1883

user: app

password: "1"

- “ serial” 配置。

配置参数（信息仅供参考）：

adapter: ezsp

port: /dev/ttyS4

e. 为了便于使用，打开 “ Show in sidebar ” 按钮，打开后会在左侧导航栏中新增出现一列 “ Zigbee2MQTT ” 栏（后续会使用到）

5. 替换原data目录，内容包含database.db、configuration.yaml、coordinator_backup.json、state.json。

a. 找到上传 “ Zigbee2CUBE ” 备份文件的入口；

选择左侧导航栏中的 “File editor”栏，随后点击右上角 “ Browse Filesystem ” 文件夹图标；

选择并打开列表中的 “ zigbee2MQTT ” 文件夹，

点击顶部菜单中的 “ Upload File ” 图标，界面右侧会出现 “ Upload File ” 的弹窗；

b.上传 “ Zigbee2CUBE ” 备份文件。

点击 “ File ” 按钮，拉起系统文件夹。选择提前从 iHost 上备份的 “ Zigbee2CUBE ” 文件，你需要提前将它解压，你会得到以下几份文件：“ configuration.yaml ”“ coordinator_backup.json ”“ database.db ”“ state.json ”选择它们，点击 “ ok ”，将它们逐一上传。