jellyfin在centos上的恢复方法

Jellyfin 在 CentOS 上的恢复方法

一 恢复准备与路径确认

• 确认安装方式：是 RPM 包 还是 Docker，两者的数据目录不同。
• 常见数据目录与配置文件路径如下（请按你的实际环境核对）：

• 建议先停服务再进行恢复操作：
  • RPM：systemctl stop jellyfin
  • Docker：docker stop <容器名>
• 恢复前备份当前目录（避免覆盖新配置）：
  • mv /etc/jellyfin /etc/jellyfin.bak_$(date +%F)
  • mv /var/lib/jellyfin /var/lib/jellyfin.bak_$(date +%F)

二 使用脚本快速恢复（推荐）

• 若此前使用 Therkelsen/jellyfin_tools 做过备份（生成如 jellyfin_backup.tar.gz），可直接用其恢复脚本：
  1. 安装工具并赋权
     • git clone https://github.com/Therkelsen/jellyfin_tools.git
     • cd jellyfin_tools
     • chmod +x create_jellyfin_backup.sh update_jellyfin_installation.sh restore_jellyfin_backup.sh restart_jellyfin start_jellyfin stop_jellyfin status_jellyfin
  2. 执行恢复（脚本会自动停止服务、解压覆盖、再启动服务）
     • ./restore_jellyfin_backup.sh
• 适用场景：跨小版本迁移、重装系统后快速还原配置与数据库。恢复后建议重启并核对设置。

三 手动恢复步骤（无脚本时）

• 步骤概览：安装同版本 Jellyfin → 恢复配置与数据 → 校验 FFmpeg → 启动并自检。
• 1. 安装同版本 Jellyfin（RPM）
     • 建议先安装依赖：yum install libicu fontconfig -y
     • 启用 EPEL 与 RPM Fusion 并安装 FFmpeg（转码必需）：
       • yum install epel-release
       • wget https://download1.rpmfusion.org/free/el/rpmfusion-free-release-7.noarch.rpm
       • rpm -ivh rpmfusion-free-release-7.noarch.rpm
       • yum install ffmpeg -y
     • 下载并安装与你备份时一致的 Jellyfin 版本（示例为 10.8.9，请按实际替换链接中的版本号）：
       • wget -c https://repo.jellyfin.org/releases/server/centos/stable/web/jellyfin-web-10.8.9-1.el7.noarch.rpm
       • wget -c https://repo.jellyfin.org/releases/server/centos/stable/server/jellyfin-server-10.8.9-1.el7.x86_64.rpm
       • wget -c https://repo.jellyfin.org/releases/server/centos/stable/server/jellyfin-10.8.9-1.el7.x86_64.rpm
       • yum install jellyfin-web-.rpm jellyfin-server-.rpm jellyfin-*.rpm
• 2. 恢复数据与配置
     • 将备份的 /etc/jellyfin 覆盖到 /etc/jellyfin
     • 将备份的 /var/lib/jellyfin 覆盖到 /var/lib/jellyfin
     • 如曾自定义日志目录，同步恢复 /var/log/jellyfin
• 3. 校验 FFmpeg 可用
     • 确认可执行：ffmpeg -version
     • 若页面设置中报 FFmpeg 路径错误，需在 Jellyfin 控制台或配置中校正 FFmpeg 路径（容器场景需保证映射一致）。
• 4. 启动与开机自启
     • systemctl start jellyfin
     • systemctl enable jellyfin
• 5. 访问管理界面 http://服务器IP:8096 核对：用户、媒体库、插件、转码设置是否正常。

四 恢复后校验与常见问题处理

• 服务状态与日志
  • 查看状态：systemctl status jellyfin
  • 实时日志：tail -f /var/log/jellyfin/jellyfin.log
  • 若启动失败，优先从日志定位错误（如权限、路径、依赖、配置）并逐项修复。
• 媒体库路径与权限
  • 确保 /var/lib/jellyfin 与媒体库目录对 jellyfin 运行用户可读写（常见为 jellyfin:jellyfin 或 997:997）。
  • SELinux 场景需放行相关域（如 httpd_t）或临时 setenforce 0 验证是否为 SELinux 导致，再按策略永久放行。
• FFmpeg 与转码
  • 若转码不可用或报路径错误，重新确认 ffmpeg 已安装并在 Jellyfin 中设置正确路径；硬件加速需按宿主机驱动与内核参数正确配置。
• 容器场景要点
  • 恢复时务必保持 /config 与 /media 的挂载路径与备份时一致；否则会出现库找不到或插件配置丢失。

五 无备份情况下的补救

• 立即停止对受影响分区的写入，优先尝试文件系统级恢复：
  • ext4 可用 extundelete：安装 e2fsprogs，只读挂载分区后执行恢复（如 --restore-all）。
  • 分区/引导损坏可用 TestDisk 进行分区与文件恢复。
• 数据恢复成功率与覆盖时间强相关，越早尝试越好；后续建议建立定期备份（如 tar 归档或配合 S3 存储）。