【免费下载链接】home-assistant-matter-hubPublish your Home-Assistant Instance using Matter.项目地址https://gitcode.com/gh_mirrors/hom/home-assistant-matter-hub点击查看免费下载Home-Assistant-Matter-Hub 可以将 Home Assistant 中的设备通过 Matter 协议发布给 Apple Home、Google Home、Alexa 等控制器。在切换 Alpha 与 Stable 版本、更换硬件或升级镜像时备份与恢复功能帮你完整保留桥接配置、实体映射和 Matter 配对身份让你无需重新配对任何设备。Home-Assistant-Matter-Hub 备份与恢复设置页面可下载配置备份和含身份数据的全量备份为什么迁移前必须备份Alpha 和 Stable 两个版本使用不同的 Add-on 标识符hamh-alpha与hamh它们各自拥有独立的数据目录。这意味着Home Assistant 系统备份无法在两个版本之间迁移数据直接切换版本后新目录里没有桥接配置控制器会认为所有设备都消失了更糟的是如果目标版本里已存在旧桥接它会带着旧的身份先启动导致控制器把设备识别为新设备丢失自定义名称和房间归属解决办法就是项目内置的备份系统它会把桥接配置、实体映射以及最关键的Matter 身份数据密钥对、fabric 凭证打进一个 ZIP 包。只要恢复了身份文件Google Home、Apple Home、Alexa 会认出原设备完全不需要重新配对。 备份文件里自带README.txt提醒全量备份包含敏感的 Matter 身份数据请妥善保管。备份入口在哪里打开 WebUI进入Settings页面最上方就是Backup Restore卡片提供三类操作操作说明Download Backup仅导出桥接配置和实体映射不含身份数据体积小、适合跨环境迁移配置Full Backup (with Identity)全量备份包含 Matter 身份文件和桥接图标跨版本迁移必选Restore from Backup上传备份 ZIP支持按桥接选择、覆盖已有桥接、是否恢复映射和身份前端界面源码位于 BackupRestore.tsxAPI 定义在 backup.ts。快照自动手动双保险除了手动下载项目还支持快照机制由 backup-service.ts 实现自动快照应用每次启动时自动执行默认开启autoBackup: true默认保留最近5 份backupRetentionCount可配置 1–100逻辑见 start-handler.ts手动快照在设置页一键创建文件名形如hamh-manual-2.0.33-2026-03-11_08-34-12.zip自动生成为hamh-auto-...切换版本之前先手动打一份快照再下载到本地保管是最稳妥的做法。跨 Alpha / Stable 迁移4 步操作以下以 Stable → Alpha 为例反向操作同理第 1 步下载全量备份含身份在当前版本运行正常时进入 Settings → Backup Restore点击Download Full Backup。⚠️ 注意一定要选含身份的版本否则恢复后所有设备都需要重新配对。第 2 步清空目标版本的数据目录启动目标版本前先清掉它的旧数据确保它是干净状态启动。通过 SSH 执行# Stable → Alpha清空 Alpha 数据 rm -rf /addon_configs/hamh-alpha/dataDocker 部署时数据默认在~/.home-assistant-matter-hub挂载到容器/data直接整目录复制备份即可参考 migration-from-t0bst4r.md。第 3 步上传并恢复启动目标版本后打开 WebUI在 Backup Restore 卡片点击Restore from Backup选择刚下载的 ZIP 文件。恢复时可选择只恢复指定桥接按桥接 ID 勾选覆盖已存在的桥接默认不覆盖避免误删是否恢复实体映射includeMappings是否恢复身份数据restoreIdentity跨版本迁移务必保持开启第 4 步重启应用恢复完成后界面会提示需要重启。点击重启后桥接会用恢复的身份重新上线控制器端无需任何操作设备名称、房间、fabrics 连接全部保留。Home-Assistant-Matter-Hub 桥接列表页面桥接状态为 Running显示 161 台设备与 2 个 fabrics恢复后如何验证没丢设备进入Devices页面核对设备数量是否与迁移前一致Home-Assistant-Matter-Hub 全部设备列表展示恢复后的桥接设备与集群信息核对要点桥接卡片上 Running 状态正常fabrics数量与迁移前一致设备总数与迁移前相同桥接页显示 devices 数量打开 Apple Home / Google Home 确认设备仍显示原来的房间和图标如果恢复结果中出现errors列表通常是目标目录权限问题或该桥接在备份中缺少身份文件按提示的bridgeId单独排查即可。常见问题 FAQQ恢复后控制器显示新设备说明身份数据没有恢复成功。请确认备份是Full Backup (with Identity)且恢复选项里勾选了恢复身份并在恢复后重启了应用。详见 faq.md。Q可以同时运行 Alpha 和 Stable 吗可以。两者使用不同端口如 8482 / 8483、不同数据目录和不同的 Matter 端口即可并存但注意桥接端口不要冲突详见 alpha-features.md。Q备份文件能直接拷贝到另一台机器吗可以。把 ZIP 在新实例的 Backup Restore 页面上传恢复即可只要恢复身份配对关系原样带过去。Q自动快照会一直占空间吗不会。保留数量由backupRetentionCount控制默认 5 份超出后自动删除最旧的快照。关键源码与文档索引内容路径备份服务快照、保留策略backup-service.ts备份/恢复 APIbackup-api.ts自动备份触发逻辑start-handler.ts备份设置默认值app-settings-storage.ts前端备份界面BackupRestore.tsxAlpha/Stable 迁移 FAQfaq.md版本迁移指南migration-from-t0bst4r.md一句话总结切版本前先Full Backup (with Identity)目标版本先清数据再恢复重启后设备一个都不少。赞分享【免费下载链接】home-assistant-matter-hubPublish your Home-Assistant Instance using Matter.项目地址https://gitcode.com/gh_mirrors/hom/home-assistant-matter-hub点击查看免费下载相关推荐为什么练习记录总丢失IELTS Atlas备份、恢复与跨设备迁移完整指南为什么练习记录总丢失IELTS Atlas备份、恢复与跨设备迁移完整指南 IELTS AtlasIELTS practice是一款雅思阅读与听力练习系统Home Assistant OS系统备份与恢复数据安全永不丢失Home Assistant OS系统备份与恢复数据安全永不丢失 引言智能家居数据安全的隐形威胁 你是否曾经历过智能家居系统配置丢失的痛苦想象一下经过数操作系统嵌入式物联网智能硬件数据永不丢失Umami完整备份与灾难恢复实战指南数据永不丢失Umami完整备份与灾难恢复实战指南 Umami作为一款简单、快速且注重隐私的Google Analytics替代方案其数据安全性至关重要。本文后端数据分析数据可视化前端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考