Home Assistant 备份与恢复完整指南
为什么要备份
Home Assistant 的配置、设备、自动化随着你用得越久积累得越多。一次意外的配置文件损坏、SD 卡故障、Home Assistant 升级报错都可能让你一切从头再来。定期备份是使用 Home Assistant 的基本纪律。
备份策略总览
| 备份类型 | 频率 | 保存位置 | 说明 |
|---|---|---|---|
| Home Assistant OS 快照 | 每周 + 每次大更新前 | NAS / 云盘 / 另一台机器 | 一键快照，最方便 |
config/ 目录 Git 仓库 | 每次改动后 | GitHub 私有仓库 | 版本控制，适合高阶用户 |
手动复制 config/ | 每月 | 本地硬盘 / 云盘 | 最保守方案 |
Home Assistant OS 快照备份
Settings → System → Backups
Home Assistant OS 的快照（Snapshot）会把你的整个 Home Assistant 实例打包成一个 .tar.gz 文件，包括：
config/目录（所有 YAML、实体状态、自动化、仪表盘）- 已安装的 App（Node-RED、ESPHome、Mosquitto 等）
- Zigbee/Z-Wave 网络密钥
- Home Assistant 数据库（历史状态、事件日志）
快照是 Home Assistant OS 最方便的备份方式——一键生成、一键恢复。
手动创建快照
- Settings → System → Backups
- 点 Create backup
- 选择 Full（完整）或 Partial（选要备份的 App）
- 等待快照生成完成（通常 1~5 分钟）
- 点快照右侧 下载 → 保存到另一台设备
自动快照调度
Home Assistant OS 支持自动快照：
- Settings → System → Backups → Schedule backups
- 选 Full 或 Partial
- 设置频率（Daily / Weekly / Monthly）
- 选一天中比较闲的时间（如凌晨 3 点）
恢复快照
Home Assistant OS 全新安装恢复：
- 刷好 Home Assistant OS → 浏览器打开 → Restoring Home Assistant 向导
- 上传你之前的快照文件 → Home Assistant 自动恢复
- 恢复完成后所有设备、自动化、仪表盘原封不动
运行中 Home Assistant 恢复：
- Settings → System → Backups → Restoring backups
- 上传快照 → Home Assistant 会覆盖当前配置并重启
⚠️ 恢复快照会完全覆盖当前配置。恢复前先确认不需要当前状态。
Container 部署的备份
Container 没有 OS 级的快照功能，需要手动备份 /config 目录：
Docker
# 备份
tar -czf homeassistant-backup-$(date +%Y%m%d).tar.gz -C /opt/homeassistant config/
# 恢复
tar -xzf homeassistant-backup-20240115.tar.gz -C /opt/homeassistant/
docker restart homeassistantSynology DSM
DSM 的备份工具可以直接备份 Docker 容器数据目录。也可以在 DSM 套件中心设置定时备份。
Git 版本控制（进阶）
把 Home Assistant config/ 目录放进 Git 仓库，每次改动后 commit：
# 进入 config 目录
cd ~/.homeassistant
# 初始化
git init
git config user.email "homeassistant@home"
git config user.name "HA"
# 创建 .gitignore
cat > .gitignore << EOF
secrets.yaml
*.db # 数据库很大，不进 Git
*.log
deps/
.venv/
EOF
# 首次提交
git add .
git commit -m "Initial Home Assistant config"
# 推送到 GitHub 私有仓库
git remote add origin <github-repo-url>
git push -u origin main这样每次改完自动化或集成配置后：
git add .
git commit -m "Update: 添加离家模式自动化"
git push好处：
- 改坏了可以
git checkout回退 - 换机器时直接
git clone下来 - 可以在 GitHub 上审查自己的改动历史
注意：secrets.yaml（存密码和 API Key）绝对不能进 Git——放在 .gitignore 里。
备份到云盘
Home Assistant 有 HACS 集成可以自动把快照同步到云盘：
| 集成 | 云盘 | 说明 |
|---|---|---|
Home Assistant Google Drive Backup | Google Drive | 最流行，自动上传保留 N 份 |
Synology Drive 官方集成 | Synology NAS | 自动同步 |
OneDrive Backup | OneDrive | 社区开发 |
S3 Backup | AWS S3 / 阿里云 OSS | 灵活但需要配置 |
什么时候该备份
一定要备份的场景：
- Home Assistant 大版本升级前（比如从 2024.12 升到 2025.1）
- 改配置文件前（尤其是大改动）
- 安装大量新集成 / App 前
定期自动备份：每周一次足够。Home Assistant 大版本可能是 buggy 的，升级前备份、升级后观察几天、确认没问题再删旧备份。
恢复失败怎么办
如果恢复快照后 Home Assistant 启动不了：
- 进入 Home Assistant OS 的 Console（HDMI + 键盘或 SSH）
- 手动
cp backup.tar.gz /data/supervisor/backup/ - 重启 Supervisor → 在 Home Assistant 界面里恢复
如果还是不行，重刷 Home Assistant OS 是最后手段——快照会覆盖新刷的系统，恢复你的完整配置。