如何更新Linux Jellyfin到最新版本

Linux 上更新 Jellyfin 到最新版本

更新前准备

• 备份关键数据：配置目录 /etc/jellyfin、数据目录 /var/lib/jellyfin，以及数据库（如使用外部数据库，请另行导出）。更新前确保服务可正常停止与启动。
• 选择更新方式：优先使用各发行版的官方仓库进行升级，便于依赖管理与回滚；仅在必要时使用手动下载 RPM/DEB方式。
• 升级后验证：确认服务运行、版本号变化、页面可正常访问。
  以上做法可显著降低升级风险并确保可回退路径。

按发行版更新步骤

• Ubuntu/Debian 系列

  1. 更新索引并升级系统：sudo apt update && sudo apt upgrade
  2. 如尚未添加官方仓库，导入 GPG 并添加源（以 Ubuntu 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
  3. 仅升级 Jellyfin：sudo apt install --only-upgrade jellyfin
  4. 重启服务：sudo systemctl restart jellyfin
  5. 验证版本：jellyfin --version
     注：Debian 步骤与 Ubuntu 相同，仅发行版代号不同。

• CentOS/RHEL 系列（使用 YUM/DNF 仓库）

  1. 备份配置与数据（见上）。
  2. 创建官方仓库文件 /etc/yum.repos.d/jellyfin.repo（以 RHEL/CentOS 8 为例，其他版本将 8 替换为对应主版本号）：
     [jellyfin]
     name=Jellyfin Repository
     baseurl=https://download.jellyfin.org/yum-repo/rhel/8/$basearch/
     enabled=1
     gpgcheck=1
     gpgkey=https://download.jellyfin.org/yum-repo/rhel/8/RPM-GPG-KEY-jellyfin
  3. 更新 Jellyfin：sudo yum update jellyfin（或使用 dnf：sudo dnf upgrade jellyfin）
  4. 重启服务：sudo systemctl restart jellyfin
  5. 验证版本：jellyfin --version。

• 手动安装包更新（RPM/DEB，适用于无仓库或离线场景）

  1. 从 Jellyfin 官方下载页获取对应系统的最新 RPM/DEB 包。
  2. RPM 系：sudo yum localinstall /path/to/jellyfin-.rpm 或 sudo rpm -Uvh /path/to/jellyfin-.rpm
  3. DEB 系：sudo apt install /path/to/jellyfin-*.deb
  4. 重启服务：sudo systemctl restart jellyfin
  5. 验证版本：jellyfin --version
     说明：手动方式同样适用于跨小版本升级，但需自行处理依赖与回滚。

Docker 部署的更新

• 拉取最新镜像：docker pull jellyfin/jellyfin:latest
• 停止并删除旧容器（注意挂载的卷保持不动）：docker stop <container_name> && docker rm <container_name>
• 使用原有卷与端口重新创建容器（示例）：
  docker run -d --name <new_container_name> -p 8096:8096 --restart=always \ -v /srv/jellyfin/config:/config -v /srv/jellyfin/cache:/cache -v /movies:/media \ jellyfin/jellyfin:latest
  提示：避免挂载覆盖整个配置目录，以免丢失数据库与插件；更新前可先备份卷数据。

常见问题与回滚建议

• 升级失败或插件不兼容：优先回滚到上一个版本。
  • RPM 系：sudo yum downgrade jellyfin 或 sudo rpm -Uvh --oldpackage /path/to/old.rpm
  • DEB 系：sudo apt install /path/to/old.deb
• 服务未启动：检查日志 sudo journalctl -u jellyfin -xe，确认端口 8096 未被占用、权限与目录挂载正确。
• 版本确认：命令行执行 jellyfin --version，或访问 http://服务器IP:8096 查看 Web 界面版本信息。
• 何时使用手动包：仓库暂未同步或内网环境；平时建议优先使用仓库更新以获得更好的兼容性与安全性。