Linux上Jellyfin如何更新

Linux 上 Jellyfin 更新指南

一 更新前准备

• 备份关键数据：配置文件目录（通常为 /var/lib/jellyfin、/etc/jellyfin）、缓存目录（如 /var/cache/jellyfin）以及媒体库元数据。可使用 rsync/tar 等方式做快照备份。
• 查看当前版本：执行 jellyfin --version；同时确认服务状态 systemctl status jellyfin，确保更新前服务可用。
• 选择维护窗口：更新过程中会有短暂不可用，建议在低峰时段进行，并确保有回滚方案（如保留旧版本包、快照或容器镜像）。

二 发行版仓库更新

• Ubuntu/Debian
  • 更新索引并升级：执行 sudo apt update && sudo apt upgrade -y，已安装时会自动升级 jellyfin 及其依赖。
  • 仅升级 Jellyfin：执行 sudo apt install --only-upgrade jellyfin -y。
  • 重启服务：执行 sudo systemctl restart jellyfin。
  • 验证版本：执行 jellyfin --version。
• CentOS/RHEL（使用官方 YUM 仓库）
  • 导入仓库（以 RHEL/CentOS 8 为例，其他版本将路径中的 8 替换为对应主版本）：
    • 创建文件 /etc/yum.repos.d/jellyfin.repo，内容：
      • [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
  • 更新与重启：执行 sudo yum update jellyfin -y 后 sudo systemctl restart jellyfin。
  • 验证版本：执行 jellyfin --version。

三 Docker 部署更新

• 拉取最新镜像：执行 docker pull jellyfin/jellyfin:latest。
• 停止并删除旧容器：执行 docker stop <container_name> 与 docker rm <container_name>（注意先记录挂载的卷与端口映射）。
• 以原有参数重新创建容器（示例）：
  • docker run -d --name <container_name>
    -p 8096:8096
    -v /srv/jellyfin/config:/config
    -v /srv/jellyfin/cache:/cache
    -v /movies:/media
    –restart=always
    jellyfin/jellyfin:latest
• 说明：上述示例映射了 /config、/cache 与媒体目录 /media，请按你的实际路径调整；更新完成即可通过 http://服务器IP:8096 访问。

四 自动更新与回滚建议

• Ubuntu/Debian 自动安全更新
  • 启用无人值守升级：执行 sudo apt install unattended-upgrades -y，按需配置 /etc/apt/apt.conf.d/50unattended-upgrades，将 jellyfin 加入自动升级名单，可在维护时段自动应用安全更新。
• CentOS/RHEL 使用 Cron 定时更新
  • 创建更新脚本（示例）：
    • #!/bin/bash sudo yum update jellyfin -y sudo systemctl restart jellyfin
  • 赋权并加入计划任务（每天 02:00 执行）：
    • chmod +x /usr/local/bin/update_jellyfin.sh
    • echo “0 2 * * * /usr/local/bin/update_jellyfin.sh >> /var/log/jellyfin_update.log 2>&1” | sudo tee /etc/cron.d/jellyfin-update
• 回滚与风险控制
  • 仓库包：使用包管理器回滚（如 yum downgrade jellyfin 或 apt install jellyfin=<旧版本>）。
  • Docker：保留旧镜像标签（如 jellyfin/jellyfin:10.8.x），回滚时直接改用旧镜像启动。
  • 通用：更新前做好配置与数据备份，更新后第一时间在控制台与日志中核验服务状态与版本信息。