私有部署数据备份与迁移
本教程适用于更换运行本地服务的管理端电脑，或迁移自己部署的独立服务端（包括 Docker）。私有部署的数据保存在用户自己的管理端或独立服务端上，不会因登录联网账号而自动恢复。
迁移最重要的是先保住设备绑定信息和授权，其次是节目。请在旧机器还能正常工作时完成备份。
设备授权务必先备份
设备列表导出的 JSON 包含设备绑定信息、连接凭据和授权信息，是迁移时最重要的备份。授权数据一旦丢失且没有有效备份，将无法恢复。
不要只导出节目，也不要把设备“报表”、截图或安装包当作授权备份。新机器完成导入并逐台确认原授权可用之前，不要删除旧服务数据、重装旧机器、解绑设备或取消授权。
迁移顺序
| 阶段 | 操作 | 完成标志 |
|---|---|---|
| 旧服务：先保授权 | 导出完整设备列表为 JSON，复制到其他存储位置 | 设备数量正确，文件已妥善保存。 |
| 旧服务：再保节目 | 逐个导出要保留的节目 ZIP，记录设备分组和播放计划 | 节目包齐全，原投放安排有记录。 |
| 新服务：先恢复设备 | 安装/启动服务，登录目标账户，导入设备 JSON | 导入结果已核对，原设备记录已恢复。 |
| 新服务：再恢复内容 | 导入节目，重建分组、投放关系和排期 | 节目内容和投放目标正确。 |
| 显示端：切换与验收 | 先切换一台测试，再逐批切换，逐台确认授权与播放 | 所有设备恢复，保留备份后再停用旧机。 |
设备 JSON 和节目 ZIP 都要留在旧机器之外。 建议至少保存两份，放在不同的存储位置，例如受控备份盘和加密存储；不要把唯一备份留在即将重装的电脑上。
第一步：确认旧服务和迁移范围
- 使用原生管理端 APP（Android、Windows、macOS 或 Linux）连接旧内网服务，核对页头的服务地址和账户。节目 ZIP 的导出/导入暂不支持 Web 管理端。
- 如果本地服务就运行在管理端电脑上，进入该电脑的本机管理；如果使用独立服务端，在管理端通过“指定主机”等入口连接旧服务地址。
- 记录设备总数、每台设备的名称/ID、授权状态和有效期，以及需要保留的节目。授权界面的截图可用于核对，但不能替代设备 JSON。
- 记录设备分组、客户/部门分配、节目对应的目标设备、起止时间、优先级、主节目/叠加节目等设置。
- 安排迁移时间，备份开始后暂停设备授权变更、节目编辑和投放修改，保证备份对应同一个状态。
如果只是更换用于连接独立服务端的管理电脑，而原服务端不变，数据仍在原服务端，通常只需在新管理端重新连接原地址。真正迁移服务主机或重装保存数据的机器时，才需要按以下流程恢复。
第二步：优先导出设备列表和授权
- 在旧服务进入“我的设备”，使用能看到迁移范围内全部设备的账户。
- 选择“全部”，清除不必要的搜索、在线/离线或分组筛选，确保要迁移的设备都在当前范围中。
- 滚动到列表底部（触屏向上滑动），继续加载后面的设备，直到没有更多数据。只看到第一屏，并不代表全部设备已经加载。
- 点击“绑定新设备”旁的三个点菜单，选择 “导出”，不要选择“报表”。
- 核对确认窗口的导出数量。若应迁移 50 台，却只提示导出 20 条，先取消，继续加载并检查筛选条件，再导出。
- 保存生成的设备 JSON，例如
device-2026-10-29-10-30.json。确认保存成功、文件存在且非空，再把它复制到备份位置。
| 导出内容 | 用途 |
|---|---|
| 设备 JSON（“导出”） | 用于恢复原设备记录、绑定所需凭据和授权信息；迁移必须优先保留。 |
| 设备报表（“报表”） | 用于查看、盘点设备；不能作为恢复绑定和授权的导入文件。 |
| 节目 ZIP | 用于恢复节目及其直接素材；不包含设备授权。 |
设备 JSON 含有连接凭据和授权信息，请限制访问并妥善保管，不要发到公开群或公开网盘。多个账户或客户/部门的设备若分批导出，应在文件名或备份清单中标明所属范围，避免遗漏。
第三步：导出节目并记录播放安排
- 仍然连接旧服务，进入“我的节目”。
- 对每个要迁移的节目打开卡片更多菜单，选择“导出”。
- 等待节目和素材准备完成，保存生成的 ZIP，并核对节目名称和包的数量。
- 把所有节目 ZIP 和设备 JSON 一起复制到旧机器之外；保留原始图片、视频等文件作为补充备份。
设备 JSON 和节目 ZIP 是两种备份，不能互相替代。 设备导入不会恢复节目；节目导入不会恢复授权。
节目包不包含原来的投放关系、设备分组、客户/部门结构、审批状态或播放历史。涉及子节目、自定义字体、网页外部资源和点击跳转时，另外记录并核对依赖；跨服务导入后不要只检查封面图。包的要求见节目导出与导入。
第四步：准备新管理端或独立服务端
- 在新机器安装并启动本地服务，确认端口、防火墙和服务地址，操作入口见私有部署。
- 若使用独立服务端，启动新服务后，用原生管理端连接新服务地址；若服务由管理端 APP 运行，则进入新机器的本机管理。
- 使用目标租户管理员登录。子账户需要设备创建权限；系统管理员应先切换到对应租户账户。
- 有多个租户、客户或部门时，先规划新环境的资源归属。导入设备按当次登录账户确定归属，不会照文件自动重建旧组织关系；按需要分批导入或在导入后重新分配。
- 管理端与本地服务应使用配套版本。如果提示服务不支持设备导入，先升级对应服务再继续。
先导入，再连接显示端
完成设备 JSON 导入前，暂不要把显示端改连新服务，也不要用动态码重新新建设备记录。 如果启用了自动接入/自动绑定，也应先避免它们创建新记录。
新服务中若提前存在相同设备 ID 或连接凭据，导入会跳过该记录，不会用备份覆盖现有数据；这可能导致原授权没有恢复。
第五步：在新服务导入设备 JSON
- 确认管理端当前连接的是新内网服务，账户归属正确。
- 进入“我的设备”，打开三个点菜单，选择“导入”。
- 选择第二步保存的原始设备 JSON，核对提示后确认导入。不要选择设备报表、节目 ZIP 或自行整理的表格。
- 阅读“导入成功、跳过、失败”的数量与明细，并与备份中的设备数核对。
- 打开恢复的设备记录，检查设备 ID 和授权信息是否与旧服务一致。原授权仍对应原来的显示设备，不会因迁移延长有效期或变成另一台设备的授权。
| 导入结果 | 如何处理 |
|---|---|
| 导入成功 | 对应设备记录已写入新服务，继续核对授权和后续实际连接。 |
| 跳过 | 设备 ID 或连接凭据已存在。检查现有记录是否已正确保留原授权，不能仅凭“跳过”认定迁移成功。 |
| 失败 | 查看明细，保留原始 JSON 和旧服务，排除问题后重试。 |
| 导入结果尚未确认 | 网络中断等原因可能导致部分设备已经导入。检查服务与网络后可重试，已存在的记录会跳过。 |
有冲突或授权信息缺失时，先停止该设备的切换，保留备份和旧服务，请维护人员核对。反复导入不会覆盖已存在的错误记录；不要靠删除重建、解绑或取消授权来试探恢复。
第六步：导入节目，恢复分组和播放计划
- 在新服务进入“我的节目”，点击“新增节目”→“导入”，选择节目 ZIP。
- 等待素材上传和节目创建完成，逐个导入其余节目。
- 打开每个节目预览，检查图片、视频、文字、字体、网页和子节目等依赖。
- 按旧记录重建设备分组、客户/部门资源分配以及节目的投放关系和排期。
- 核对投放目标、替换/追加、起止时间、优先级、主节目/叠加节目。多个节目需要共存时，避免后一次“替换”移除了前面的安排。
节目导入会创建新节目和新素材，节目 ID 会改变；重复导入不会更新原节目，而是再创建一份。依赖旧节目 ID 的子节目或跳转也要重新检查。设备分组和排期不会从这些 ZIP 自动恢复，详见配置播放计划。
第七步：让显示端连接新服务
先选一台实际显示设备测试：
- 在电视前按遥控器“返回”键进入显示端主界面；没有遥控器的触摸设备可双击进入。
- 找到“私有部署/内网服务”的管理服务地址，改为新服务的 IP/域名和端口。
- 等待连接，确认管理端原来导入的那条设备记录变为在线。
- 检查原授权是否仍有效，等待节目同步后，到电视前确认实际播放。
如果新服务沿用原固定 IP/域名和端口，可减少逐台改地址的操作，但要避免旧、新主机地址冲突；切换前应让旧服务退出该地址。地址相同不代表数据已迁移，设备和节目仍需先恢复。
第一台确认成功后，再逐批切换其他显示端。遇到问题先保留旧服务和备份，核对新地址、账户、原设备 ID、凭据与授权，不要重新购买授权来代替排查。
第八步：逐台验收后，再停用旧机器
- [ ] 迁移范围内设备数量正确，设备 ID 与旧清单一致，均能连接新服务。
- [ ] 每台设备的原授权状态和有效期正确，没有因换管理服务而丢失授权。
- [ ] 节目和素材完整，实际显示效果正确；子节目、字体、网页等依赖可用。
- [ ] 分组、客户/部门分配、投放目标和排期已恢复。
- [ ] 定时节目能按时切入、退出，并恢复常规内容。
- [ ] 重启新服务后，设备、授权和节目仍然保留，显示端能重新连接。
- [ ] 设备 JSON、节目 ZIP 和必要配置已有独立备份，旧服务数据仍保留到验收完成。
全部确认后，才停用旧服务；确认备份可用之前，不要清除或格式化旧机器。以后每次新增设备、变更授权或修改节目，也应更新对应备份。
常见问题
只是换管理用的电脑，独立服务端没换，也要导入吗？
通常不需要。在新管理端连接原独立服务端即可；数据仍在该服务端。本教程主要用于服务主机迁移、服务数据搬家或保存数据的机器重装。
为什么不能重新登录联网账号找回本地授权？
私有服务的数据保存在用户自己部署的管理端或独立服务端，不是随联网账号自动恢复的云端数据。授权数据丢失且没有有效备份，将无法恢复。
旧机器已经坏了，没有导出怎么办？
先查找以前保存的设备 JSON 或完整服务备份。不要继续重装旧机器或清理旧磁盘，保留现有文件，请维护人员确认是否还有可读取的有效副本。若授权数据已丢失且没有任何有效备份，就不能靠节目 ZIP、设备报表或重新绑定找回授权。
导入后有设备，但仍提示未授权怎么办？
停止切换，核对是否选错备份文件、导出前是否已读取到原授权、导入是否因重复记录而跳过，以及显示端是否连接了正确的新服务。保留原始文件和旧服务用于核对，不要先取消授权或删除设备。授权机制见设备授权说明。
部署维护人员：完整服务备份作为补充
设备 JSON 和节目 ZIP 是上述迁移流程的核心备份。有维护条件时，还应补充保留完整服务环境，便于恢复账号、配置和其他数据：
- 暂停写入并正常停止旧服务，再备份完整数据目录、数据库及其相关文件、素材和启动配置。不要在服务运行时只复制一个 SQLite 文件。
- 记录应用/服务版本、实际数据位置、工作目录、端口和地址；不同平台路径不同，不要照搬其他机器的目录。
- 独立服务端使用 Docker 时，保留
mhtdata等持久化数据；使用联网点对点任务时，也保留原实例的 P2P 主密钥及相应配置。密钥可能位于工作目录之外。 - 用完整目录恢复时，选择与备份兼容的服务版本并由维护人员验证。不要在同一目标库中混用整库覆盖和逐项导入而不核对结果。
只保存安装包、容器镜像或素材清单不包含实际业务数据。备份可能含账号、连接凭据、API Key 和密钥，应限制访问并加密保存。