Linux如何更新Jellyfin版本

Linux 更新 Jellyfin 版本

更新前准备

• 备份关键数据：配置文件目录（通常为 /var/lib/jellyfin）、缓存目录（通常为 /var/cache/jellyfin）、媒体库元数据与数据库，以及任何自定义 FFmpeg 或插件目录。
• 查看当前版本：执行 jellyfin --version；同时确认服务状态 systemctl status jellyfin。
• 选择维护窗口：升级期间会出现短暂不可用，建议在低峰时段进行。
• 依赖与驱动：确保系统已安装必要依赖（如 FFmpeg）；如使用 Intel 核显，建议安装 intel-media-va-driver-non-free 并用 vainfo 验证硬解可用性。

不同发行版的更新方法

• Ubuntu/Debian 系列（APT）

  1. 更新索引并升级：执行 sudo apt update && sudo apt upgrade -y。
  2. 如尚未添加官方源，先导入 GPG 并写入源：
     • Ubuntu：
       wget -O - https://repo.jellyfin.org/ubuntu/jellyfin_team.gpg.key | sudo apt-key add -
       echo “deb [arch=$(dpkg --print-architecture)] https://repo.jellyfin.org/ubuntu $(lsb_release -cs) main” | sudo tee /etc/apt/sources.list.d/jellyfin.list
     • Debian：
       wget -O - https://repo.jellyfin.org/debian/jellyfin_team.gpg.key | sudo apt-key add -
       echo “deb [arch=$(dpkg --print-architecture)] https://repo.jellyfin.org/debian $(lsb_release -sc) main” | sudo tee /etc/apt/sources.list.d/jellyfin.list
       然后再次 sudo apt update。
  3. 执行升级：
     • 常规：sudo apt install jellyfin -y
     • 仅升级：sudo apt install --only-upgrade jellyfin -y
  4. 重启服务：sudo systemctl restart jellyfin
  5. 验证：jellyfin --version
  6. 可选自动更新：启用 unattended-upgrades 并在其配置中确保包含 jellyfin 包，以实现无人值守升级。

• CentOS/RHEL 系列（YUM/DNF）

  1. 检查当前版本：jellyfin --version。
  2. 导入官方仓库后，使用包管理器更新（推荐）：sudo yum update jellyfin -y 或 sudo dnf update jellyfin -y。
  3. 如采用手动下载 RPM 的方式，依次安装新版本的三个包（示例）：
     • jellyfin-.rpm
     • jellyfin-server-.rpm
     • jellyfin-web-.rpm
       命令示例：sudo yum localinstall jellyfin-*.rpm。
  4. 重启服务：sudo systemctl restart jellyfin。
  5. 验证：jellyfin --version。

• Docker 部署

  1. 拉取最新镜像：docker pull jellyfin/jellyfin:latest。
  2. 停止并删除旧容器（数据卷挂载保持不变）：docker stop <container_name> && docker rm <container_name>。
  3. 使用原有参数重新创建容器（示例）：
     docker run -d --name <container_name> -p 8096:8096 --restart=always \ -v /srv/jellyfin/config:/config -v /srv/jellyfin/cache:/cache -v /movies:/media \ jellyfin/jellyfin:latest
  4. 验证：访问 http://<服务器IP>:8096 或查看容器日志 docker logs <container_name>。

升级后验证与常见问题

• 版本与服务：执行 jellyfin --version 与服务状态 systemctl status jellyfin，确认已为新版本且运行正常。
• 页面与日志：访问 Web 管理端确认界面加载正常；如有异常，查看 /var/log/jellyfin/ 下的日志定位问题。
• 硬件解码：升级后建议复核 Intel 核显驱动（如 intel-media-va-driver-non-free）并用 vainfo 检查硬解是否仍可用。
• 回滚方案：如升级异常，可基于备份快速回滚配置与数据库；使用系统包管理器时，可降级到上一个版本（如 sudo apt install jellyfin=<旧版本> 或 sudo yum downgrade jellyfin-<旧版本>）。