配置备份与恢复
介绍如何将网关的 PLC 注册信息 / 标签 / 环境设置保存在安全的地方，并在需要时进行恢复的方法。
容器模式盒子在 OTA 升级时会自动生成 pre-snapshot
（/data1/pp-backups/pe-backup-<ts>.tar.zst）。UI 的“备份”按钮会调用 host 上的 backup.sh
作为信号文件 —— 批量快照 Cassandra drain + Redis AOF + HiveMQ + Node-RED + /etc/kopens。
恢复是通过 SSH 执行 restore.sh <archive>（恢复当前状态后也会自动进行备份）。
手动：sudo bash /opt/kopens/install/bin/backup.sh。有关详细信息，请参阅
备份与恢复。
何时需要备份
| 情况 | 建议 |
|---|---|
| 首次完成所有 PLC / 标签注册时 | 进行第 1 次备份 |
| 重大变更（添加/修改数十个标签）后 | 变更后立即备份 |
| 定期（每周 / 每月） | 作为运维标准 |
| 升级 / 重新安装之前 | 必须进行 |
1. 在界面上进行备份
点击右上角的 [设置] 齿轮图标 → 备份（时钟形状的图标）。
- 会自动生成备份文件。
- 下载位置 / 文件名因环境而异。
- 通常会保存在 PC 内部的备份目录中，或者立即开始下载。
请将生成的文件移动到单独的安全存储库（公司内 NAS、云盘等）。如果网关 PC 本身损坏，其上的备份也会一并丢失。
2. 用 CSV 导出 PLC / 标签
除了完整备份外，如果您想仅在 Excel 中查看和管理 PLC / 标签列表，可以使用 CSV 导出功能。
- 在 [连接] 菜单 → [CSV 批量上传] 界面中，有类似“下载当前注册内容”的选项。
- 下载的 CSV 在 Excel 中编辑后，再重新批量上传即可。
CSV 也可以作为可编辑的备份来使用。
3. 恢复（Restore）
需要恢复的情况（更换 PC / 重新安装 / 回滚错误的更改）通常需要系统管理员的帮助。
大致步骤：
- 安装 / 启动新网关
- 使用相同的系统管理员账户登录
- 将备份文件上传到网关主机
- 系统管理员执行恢复脚本（或恢复 Cassandra 数据）
- 重启网关
如果是使用 CSV 备份进行恢复，可以通过 [连接] → [CSV 批量上传] 重新批量注册。
常见问题解答
Q. 备份文件通常多大？
如果 PLC / 标签数量在 100 到 1000 个左右，通常为数 MB 到数十 MB。如果连同时序数据一起备份，可能会大得多（请向管理员另行请求规划）。
Q. 时序（历史数据）也会备份吗？
默认备份仅包含配置。时序数据在独立的存储库（如 Cassandra）中管理，需要单独的备份策略。请与系统管理员一起确认时序数据的备份 / 保留期限。
Q. 密码也包含在备份中吗？
包含管理员密码 / MQTT 密码等。请勿随意共享备份文件。 如果可能，建议加密存储。
Q. 如何设置自动备份？
可以通过操作系统的 cron / 任务计划程序设置定期执行备份命令。请向系统管理员请求引入自动备份。