数据维护
路径：系统 → 数据维护。
数据维护分为“概览、执行策略、备份恢复、系统升级”。检查、维护、备份、导出、恢复和升级的记录统一在“概览”查看，可按类型、状态、来源和时间筛选。日常维护和备份仍在各自入口操作：
| 项目 | 作用 | 建议 |
|---|---|---|
| 每日维护时间 | 定时清理旧记录并整理数据库。 | 选择不常使用 Mediora 的时间。 |
| 月度维护日期、时间 | 每月进行一次更深入的空间整理。 | 选择 1–28 日和空闲时段。 |
| 运行日志保留（天） | 各类运行日志保留多久，默认 30 天。 | 需要长期排查问题时调大；空间紧张时调小。 |
| 任务历史保留（天） | 整理、刮削等历史记录保留多久，默认 180 天，最少 8 天。 | 想查更早的文件去向时调大。 |
| 备份保留份数 | 自动生成的每日、每周、每月备份各保留多少份。 | 至少保留多份，不要只留一份。 |
| 导出完整备份 | 下载包含数据库、配套身份与密钥、应用配置和归档的 .mediora.tar.gz。 | 可用同版本镜像恢复到新的空安装目录；部署文件需只读挂载后纳入，媒体另行备份。 |
| 导入备份 | 用当前安装配套的 .db 或 .db.gz 恢复数据库。 | 校验通过后替换当前数据并重启，需要重新登录；不支持任意旧结构或其他安装的数据库。 |
| 系统升级 | 检查 Docker Hub 官方版本，手动或按维护时段升级主产品。 | 自动升级默认关闭；安装版本、Docker 权限、部署条件及目标兼容信息均须通过检查。 |
“导出完整备份”和“导入备份”处理的文件格式不同。 新下载的 .mediora.tar.gz 包含配套密钥，迁移或重装时要停机恢复到新的空目录，不能在网页“导入备份”中上传。网页入口只接收同一安装配套的旧 .db / .db.gz，导入会替换当前配置与记录，不是把两份数据合并。完整步骤见备份与恢复。
两个保留天数分别管什么
在“执行策略”里，两个保留天数下方都会列出“包括：……”。这份清单由 Mediora 根据当前版本自动生成，内容以页面显示为准。
运行日志保留管的是过程记录，主要用来排查问题，过了排查的时间就没什么用了：
- 整理、刮削、STRM、同步任务的运行日志；
- 工作流里不属于某一次执行的日志；
- 媒体代理的播放请求记录；
- 下载助手收到的聊天消息；
- 影音优化收到的媒体服务器事件和起播耗时记录。
任务历史保留管的是结果记录，用来回查“某个文件什么时候被处理、放到了哪里”：
- 整理、刮削、STRM、同步历史（同步历史连同它的错误明细一起保留）；
- 工作流执行记录和每次执行的日志；
- 下载助手的下载记录；
- 影音优化的处理任务记录。
这些记录超过天数后，会在每日维护时先写入 data 目录下的归档文件，确认写入成功后再从数据库中删除。任务历史只处理已经结束的记录，正在运行、排队或暂停中的不会被动；下载助手的一批下载，要等其中每个链接都下载结束、下载完成后的处理也都做完，才会被清理。
归档还会保留解释这次任务所需的相关记录。尚未结束的工作流、活动任务和待核实写入仍需要的记录，不会仅因保留天数到了就被清除。归档核对失败时会保留数据库里的原记录，应到“概览”的维护记录查看原因。
每日维护开始时，如果有任务正在运行，当天的归档会跳过，第二天再试；排队或暂停中的任务不影响维护。
另外还有一些只在短期内有用的辅助记录，也按这两个天数直接删除、不写入归档文件，例如较早的维护记录、已经回复过的工作流交互消息，以及影音优化里已经不再使用的中间数据。
备份保留多久
| 备份类型 | 保留规则 |
|---|---|
| 每日、每周、每月备份 | 按“执行策略”里设置的份数保留，更早的自动删除。 |
| 导入前安全备份 | 每次导入数据库前，Mediora 会先创建完整安装包，以便导入出错时还能找回。只保留最近 3 份，更早的连同备份文件一起自动删除。 |
| 手动备份 | 永久保留，不会被自动删除。不再需要时，在“备份恢复”的备份列表里点“删除”，移除文件和备份列表项；概览中的历史仍保留，详情标明“备份文件已清理”。 |
在“概览”里点“立即维护”时生成的备份属于手动备份，同样需要自己删除。
新生成的手动、定时及导入前安全备份统一为完整安装包；旧 .db / .db.gz 仍只包含数据库，需要原安装密钥和归档配套。备份均不包含 NAS / 网盘媒体。包中部署材料的实际覆盖范围及空目录恢复步骤见备份与恢复，不要只下载一个 .db 就删除原安装。
维护失败或占用空间没有下降
- 在“概览”的维护记录查看本次是否因业务运行跳过，还是备份、归档或空间整理失败。
- 检查专用数据目录剩余空间与写权限；归档和升级也需要临时副本空间。
- 旧历史从主库转到归档不等于从磁盘永久删除，备份也会继续占空间。分别查看数据库、归档和备份大小。
- 有待核实写入时，先从原任务或存储入口处理；不要手动删除数据库表、归档文件或恢复记录来释放空间。
启动升级产生的备份与普通自动备份保留策略不同，不能只按“每日保留份数”推断可删除哪些升级材料，详见正式版数据升级。
系统升级
在“系统升级”中检查 Docker Hub 官方版本，查看目标版本、兼容信息与当前升级环境。首次安装带有站内升级能力的版本，仍需按原安装方式拉取镜像并重建容器；之后由管理员配置 Docker 控制权限及部署条件，页面检查就绪后才可执行。只有带有完整兼容声明及发布就绪信息的官方目标版本可以安装。
自动升级默认关闭。主动开启后，默认按系统时区在 04:00—05:00 等待空闲，只自动安装同一主版本的兼容正式版。活动任务、播放、其他维护和待核实写入会阻止停机；错过维护窗口后顺延，不会强行停止业务。
手动升级也会先等待空闲，可在真正停机前取消。停机后会保存成套备份，再验证新版；浏览器关闭不影响已经受理的升级。结果和恢复状态在“概览”核对；需要人工恢复时保留页面所列材料，按备份与恢复处理。通过 Docker run 安装的用户，还应在成功后主动导出并妥善保存启动配置。
影音优化中已不再使用的备份文件
影音优化可以在 STRM 旁或指定的存储目录保存结果备份（见影音优化的备份方式）。这些文件保存在对应存储中，数据库备份不包含它们的内容。
变更备份位置后，已有备份文件不会自动搬迁或删除。当前页面不提供独立的旧备份清理列表；需要清理时，在文件所在的存储中核对并处理，确认保留仍需使用的备份。
已刮削文件的记录会自动更新
Mediora 会记住刮削过的影片文件和对应的作品信息。这份记录会自动跟着文件变化：
- 在云盘管理里移动、改名或删除已刮削的文件或文件夹后，记录会立即跟着更新，不需要重新刮削；
- 两个不同存储上路径相同的文件，会分别记录，不会互相覆盖；删除一个存储时，只清除这个存储上的记录；
- 对某个目录完整地整理或刮削扫描一遍之后，这个目录里已经不存在的文件会从记录中移除；只处理部分文件的扫描、被取消或出错的扫描不会移除任何记录；
- 重新刮削后换成了另一部作品，旧作品的信息在没有任何文件使用后，超过运行日志保留天数就会被清理。
示例：建立一份可用于迁移的备份
- 到“备份恢复”查看备份覆盖情况，确认应用数据和密钥已包含；部署文件未纳入时，另行保留 Compose 或创建命令。
- 点击“导出完整备份”，确认下载完成，文件后缀为
.mediora.tar.gz。 - 把副本放到另一台设备或另一块磁盘，妥善保护其中的凭据。备份只放在原
data所在磁盘上，无法应对该磁盘整体故障。 - 记下对应 Mediora 镜像版本、媒体目录映射及端口。需要恢复时，按备份与恢复在新空目录验证，先保留原目录。
影片、网盘内容、STRM 所在存储里的影音优化备份，需要按各自存储另行备份；它们不因完整安装包里有数据库记录就被一起打包。
空间紧张时先检查什么
先看“概览”中的容量与维护记录，分清空间用于数据库、历史归档还是备份。历史从数据库移入归档后，磁盘上仍保存着这些文件，不等于总占用已经消失。
可以先核对备份列表，保留近期成功备份以及需要长期留存的版本，再通过页面删除确定不用的手动备份。调整自动备份份数后，也要观察下一次维护结果。不要按固定硬盘容量直接套用保留天数：任务数量、日志量和需要回查多久，比硬盘标称容量更有参考价值。
当前页面没有通用的“删除全部归档”或“清理全部影音优化备份”入口。不要为了腾空间手工删数据库表、历史归档、升级材料或待核实记录；先处理页面中的维护失败与待核实提示，再按备份恢复说明判断哪些材料可以删除。