如何在Linux上更新Jellyfin到最新版本

Linux 更新 Jellyfin 到最新版本

一 通用准备

• 备份重要数据：优先备份 /var/lib/jellyfin、/etc/jellyfin、以及你的 媒体库与数据库，避免更新异常导致数据丢失。
• 确认安装方式：常见为 APT（Debian/Ubuntu）、YUM/DNF（RHEL/CentOS/Fedora）、Docker/Portainer。不同方式升级路径不同。
• 维护窗口：升级期间会重启服务，建议在低峰时段进行，并确保有回滚方案（如快照/备份）。

二 基于 Debian 或 Ubuntu 的更新

• 更新索引并升级系统包：
  sudo apt update && sudo apt upgrade -y
• 若尚未添加官方仓库，先导入 GPG 并添加源（以 Ubuntu 20.04/22.04 为例）：
  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
• 执行升级（两种等效方式）：
  sudo apt install jellyfin -y
  或仅升级已安装包：sudo apt install --only-upgrade jellyfin -y
• 重启服务并验证版本：
  sudo systemctl restart jellyfin
  jellyfin --version
  完成后通过 http://服务器IP:8096 访问，确认服务正常与版本号更新。

三 基于 RHEL、CentOS 或 Fedora 的更新

• 导入官方仓库（以 RHEL/CentOS 8 为例，其他版本将 rhel/8 替换为你的系统代号）：
  sudo tee /etc/yum.repos.d/jellyfin.repo << EOF
  [jellyfin]
  name=Jellyfin Repository
  baseurl=https://download.jellyfin.org/yum-repo/rhel/8/$basearch/
  enabled=1
  gpgcheck=1
  gpgkey=https://download.jellyfin.org/yum/RPM-GPG-KEY-jellyfin
  EOF
• 更新系统并升级 Jellyfin：
  sudo yum update -y
  sudo yum update jellyfin -y
• 如使用 RPM 本地包 升级：
  sudo yum localinstall /path/to/jellyfin-*.rpm -y
• 重启服务并验证：
  sudo systemctl restart jellyfin
  jellyfin --version
  访问 http://服务器IP:8096 确认运行状态与版本。

四 使用 Docker 或 Portainer 的更新

• 拉取最新镜像：
  docker pull jellyfin/jellyfin:latest
• 停止并删除旧容器（请先确认你的卷挂载路径，如 /config、/cache、/media）：
  docker stop jellyfin && docker rm jellyfin
• 以原有参数重新创建容器（示例）：
  docker run -d --name jellyfin -p 8096:8096 \ -v /path/to/config:/config -v /path/to/cache:/cache -v /path/to/media:/media \ jellyfin/jellyfin:latest
• 使用 Portainer：在容器列表中选择 Jellyfin，执行 Pull 最新镜像后 Recreate 容器（保持原有卷和环境变量不变）。更新完成后通过 http://服务器IP:8096 验证。

五 验证与回滚建议

• 验证：
  • 命令行：jellyfin --version 查看是否为最新版本号。
  • 界面：访问 http://服务器IP:8096，在 仪表盘 > 关于 中核对版本与服务器状态。
• 常见问题与回滚：
  • 升级失败可先检查日志：sudo journalctl -u jellyfin -xe；必要时用备份恢复 /config 与数据库。
  • 若使用 Docker，务必确保 卷挂载 正确，避免数据被覆盖；回滚时重新运行旧镜像并挂载原卷即可。
  • 不建议跨多版本一次性大跳升级，生产环境建议先在测试环境验证或在维护窗口操作。