Jellyfin在Ubuntu上的备份与恢复方法

Jellyfin在Ubuntu上的备份与恢复方法

一 备份与恢复总览

• 核心数据包含：Jellyfin的配置与数据库（默认位于**/var/lib/jellyfin**）、插件与缓存、以及你的媒体文件（电影、剧集等）。
• 推荐同时做好两类备份：
  • 配置与数据库备份：保证用户、播放记录、插件设置不丢失。
  • 媒体库备份：保证媒体文件可访问（若媒体已存在，可只做增量同步）。
• 建议在备份前停止Jellyfin服务，避免写入导致不一致；恢复后核对权限与路径映射。

二 原生备份与恢复（APT安装）

• 备份步骤
  1. 停止服务：sudo systemctl stop jellyfin
  2. 打包配置与数据：sudo tar -czvf jellyfin_backup_$(date +%F).tar.gz -C /var/lib/jellyfin .
  3. 备份媒体库（示例）：sudo rsync -avz /path/to/media /path/to/backup/
  4. 如需远程/云端存储，可将归档复制到外部介质或对象存储。
• 恢复步骤
  1. 先安装同版本Jellyfin（如通过APT），再停止服务：sudo systemctl stop jellyfin
  2. 恢复配置：sudo tar -xzvf jellyfin_backup_YYYY-MM-DD.tar.gz -C /var/lib/jellyfin
  3. 恢复媒体：sudo rsync -avz /path/to/backup/media/ /path/to/media/
  4. 启动服务：sudo systemctl start jellyfin
  5. 登录Web管理端（默认端口8096）检查用户、插件与库是否正常。

三 Docker部署的备份与恢复

• 备份步骤
  1. 停止容器：docker stop jellyfin
  2. 备份配置目录：docker cp jellyfin:/config /path/to/backup/jellyfin-config
  3. 备份媒体（宿主机路径）：rsync -avz /path/to/media /path/to/backup/media
• 恢复步骤
  1. 启动新容器并挂载已备份的配置与媒体（注意路径映射保持一致）：

     docker run -d --name jellyfin \
       -p 8096:8096 \
       -v /path/to/backup/jellyfin-config:/config \
       -v /path/to/media:/media \
       jellyfin/jellyfin
     

  2. 首次启动后检查控制台与日志，确认插件、用户与库加载正常。

四 跨系统或路径变更的迁移增强

• 当从Windows迁移到Linux、或更改了媒体库路径时，可使用开源迁移工具Jellyfin-Migrator自动处理路径差异与ID映射，尽量保留用户、观看记录与插件数据。
• 基本流程
  1. 在新服务器安装同版本Jellyfin并可达Web界面。
  2. 克隆并配置脚本中的源/目标路径映射（支持Docker内外路径替换）。
  3. 运行迁移脚本，完成后在新环境启动Jellyfin并核对日志与功能。

五 自动化与注意事项

• 自动化与系统级备份
  • 可用Timeshift做系统级快照（含配置与程序），适合回滚系统状态；对媒体库建议单独用rsync做周期性增量备份。
• 关键注意事项
  • 备份前尽量停止Jellyfin，减少数据库不一致风险；恢复后确保**/var/lib/jellyfin**与媒体目录的所有权和权限正确（Jellyfin运行用户需可读写）。
  • 迁移或恢复后如出现媒体“未找到/扫不到”，多为路径映射不一致，需在Jellyfin控制台重新检查媒体库路径或在迁移工具中完善路径替换规则。
  • 若使用Docker，务必保持卷挂载路径与备份时一致；变更挂载路径通常需要重新配置库路径或借助迁移工具修正。