配置备份 / 恢复
本文介绍如何将网关的 PLC 注册信息 / 标签 / 环境配置保存到安全位置，并在需要时进行恢复。
容器模式设备在 OTA 升级时会自动创建 pre-snapshot
(/data1/pp-backups/pe-backup-<ts>.tar.zst)。UI 上的“备份”按钮通过 signal file 调用 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. 在界面上备份
点击右上角的 [设置] 齿轮图标 → 备份（时钟形状图标）。
- 系统会自动生成备份文件。
- 下载位置 / 文件名因环境而异。
- 通常保存在 PC 内部的备份目录中，或立即下载。
请将生成的文件转移到 单独的安全存储 （公司内部 NAS、云盘等）。如果网关 PC 本身损坏，存放在其上的备份也会一并丢失。
2. 以 CSV 导出 PLC / 标签
除完整备份外，如果只想 导出 PLC / 标签列表 并在 Excel 中查看和管理，可以使用 CSV 导出功能。
- 在 [连接] 菜单 → [CSV 批量上传] 界面中，有类似“下载当前注册内容”的选项。
- 在 Excel 中编辑下载的 CSV 后，可再次批量上传。
CSV 也可作为 可编辑的备份 来使用。
3. 恢复 (Restore)
需要恢复的场景（更换 PC / 重新安装 / 回退错误变更）通常需要系统管理员协助。
大致流程：
- 安装 / 启动新网关
- 使用相同的系统管理员账户登录
- 将备份文件上传到网关主机
- 由系统管理员执行恢复脚本（或恢复 Cassandra 数据）
- 重启网关
若使用 CSV 备份进行恢复，可通过 [连接] → [CSV 批量上传] 重新批量注册。
常见问题
Q. 备份文件通常有多大？
如果 PLC / 标签在 100 ~ 1000 个左右，通常为 数 MB ~ 数十 MB。若同时备份时序数据，体积会大得多（请向管理员申请单独的方案）。
Q. 时序（历史数据）也会被备份吗？
默认备份 仅包含配置。时序数据由独立存储（如 Cassandra）管理，需要单独的备份策略。请与系统管理员一并确认时序备份 / 保留周期。
Q. 密码也包含在备份中吗？
管理员密码 / MQTT 密码等会被包含在内。请勿随意共享备份文件。 建议尽可能采用加密存储。
Q. 如何设置自动备份？
可以通过操作系统的 cron / 任务计划程序设置定期执行备份命令。请向系统管理员申请引入自动备份。