备份与恢复

最重要的是备份安装目录中的 data。它保存账户登录状态、密钥、设置和本地运行文件。媒体文件是否备份，请按自己的硬盘或网盘方案安排。

主产品只使用 data 中的 SQLite 数据库，不支持另外配置 PostgreSQL。独立 Accounts 服务使用自己的 PostgreSQL，由它的管理员另行备份，不能与主产品混用数据库或数据目录。

定期备份

暂停正在自动运行的任务。
按原安装方式停止 Mediora：Compose 执行 docker compose stop mediora，命令方式执行 docker stop -t 180 mediora，绿联手动容器在 Docker 界面关闭。先等待在途写入结束，不强制停止。
复制整个 data 目录到其他硬盘、NAS 或可信的备份位置。
记录当前实际使用的版本镜像或摘要，与这份完整数据目录配对保存。
保存部署配置：Compose 文件、完整创建命令，或绿联容器的镜像、目录、端口与环境参数。配置中的凭据要妥善保管。
启动原容器：Compose 使用 docker compose start mediora，命令方式使用 docker start mediora，绿联手动容器在界面启动。备份不需要新建容器。

不要只复制正在使用的数据库主文件。完整目录还包括安装身份、会话密钥、存储配置密钥和恢复材料，缺少配套密钥时无法解开已有存储配置。定期在独立目录和对应版本镜像中实际验证恢复。

备份	包含	仍需另外保留
停机复制整个 `data`	该安装的数据、身份、密钥、归档及其中的运行材料。	镜像标签或摘要、Compose / 创建命令 / 绿联容器参数、媒体及外部写入结果。
页面导出的 `.db` / 自动数据库备份	数据库快照中的设置、任务和记录。	配套安装身份和密钥、独立归档文件及数据库外的材料。
影音优化结果备份	某个视频准备好的播放信息。	影片本身、Mediora 和媒体服务器完整数据。
同步复制的媒体	同步范围内实际复制到目标的文件。	Mediora 配置和历史；开启同步删除后也不等同于可找回旧版本的备份。

备份应放在独立位置。把原数据旁边的文件夹当作唯一备份，无法抵御同一磁盘或账号故障。涉及数据库和密钥的副本与含凭据的部署配置都应妥善保管。

恢复前先停止 Mediora，把成对的完整 data 备份放到独立目录，使用对应版本镜像演练。核对登录、存储和任务后，再在维护窗口切换。结构、密钥和安装身份不匹配时会被拒绝；不会为未知旧结构自动补表。跨不兼容的已发布版本仍按 changelog 使用新的空数据目录。

恢复会覆盖当前的设置和任务记录。先把当前 data 目录另存一份，避免需要回退时没有副本。

恢复演练不要与正式实例同时操作相同网盘、下载目录或媒体库。先隔离外部写入和自动触发，核对文件实际状态，再逐项恢复计划。数据库回退不能撤销备份点之后已经发生的外部操作。

1.0.2 支持对 1.0.0 / 1.0.1 已发布完整结构的启动升级。它根据实际数据库结构识别，不能仅改版本标记或给旧开发库补列来满足要求；旧预发布版和旧开发库不在兼容范围内。

停止旧实例，备份完整 data，记录旧镜像并确认有足够空间容纳数据库备份、副本和归档转换。
先在独立副本和隔离环境验证。需要实际切换时，在维护窗口使用 1.0.2 镜像启动，保留原目录与冷备份。
查看启动日志。系统先在 data/database-upgrades/upgrade-*/original.db 保存一致的旧数据库快照，在副本转换并完整校验后才替换主库；原月份归档保留，新归档使用独立代次。
启动成功后，核对账户、存储、命名规则、任务、历史及归档。旧的未结束媒体运行和工作流会取消，受影响的自动计划会停止；查看未决写入和实际文件后，再决定是否重新执行或启用计划。
升级失败时保留完整目录、备份和错误提示。不要删除数据库、密钥或安装身份来“修复启动”；回退仍恢复旧镜像和完整旧数据目录。

升级过程中的 original.db 是数据库快照，不是完整安装备份，不能单独作为回退材料。升级适用范围见更新日志，实际切换前仍需用自己的完整数据副本验证。

“设置 → 数据维护”导出 SQLite .db。恢复支持当前安装的普通 .db 和压缩 .db.gz；它们只包含数据库，不代替 data 中的密钥和运行材料。恢复前必须保留同一安装、同一备份时间点的完整材料，不能把别的安装的数据库导入当前身份。

数据库恢复会撤销旧的页面和 Agent 授权，恢复后需要重新登录。数据库回滚不会撤回已经发生的媒体改名、覆盖、删除或外部同步，恢复演练时应另外核对外部文件。

页面导入只接受当前结构的备份，不负责把任意旧备份升级。已支持的旧正式版备份，应先在对应旧镜像与配套安装材料中恢复，再按启动升级流程验证；不要直接导入新实例。存在活动作业或待核实写入时，按页面保护提示先处理原操作，不删除保护记录绕过导入限制。