Linux系统如何更新Jellyfin

Linux系统更新 Jellyfin 的实用步骤

一 更新前准备

• 备份关键数据：建议先备份 /config、/cache 以及媒体库元数据目录，避免意外丢失配置或缓存。
• 查看当前版本：执行 jellyfin --version 记录升级前后版本，便于回滚或排查。
• 选择维护窗口：尽量在业务低峰期操作，避免中断正在进行的播放或转码任务。

二 发行版仓库更新

• Ubuntu/Debian
  1. 更新索引并仅升级 Jellyfin：执行 sudo apt update && sudo apt install --only-upgrade jellyfin -y。
  2. 重启服务：执行 sudo systemctl restart jellyfin。
  3. 验证版本：执行 jellyfin --version。
     说明：若已添加 Jellyfin 官方仓库，执行系统升级（如 apt upgrade）时也会自动升级 Jellyfin。
• CentOS/RHEL 或兼容发行版
  1. 通过仓库更新：执行 sudo yum update jellyfin -y（或 dnf update jellyfin -y）。
  2. 重启服务：执行 sudo systemctl restart jellyfin。
  3. 验证版本：执行 jellyfin --version。
     说明：如未配置官方仓库，可先导入 RPMFusion 与 Jellyfin 仓库，再用包管理器升级。

三 Docker 部署的更新

• 拉取最新镜像：执行 docker pull jellyfin/jellyfin:latest。
• 停止并删除旧容器：执行 docker stop <container_name> && docker rm <container_name>。
• 使用原有卷与端口重新启动：
  docker run -d --name <container_name>
  -p 8096:8096
  -v /path/to/config:/config
  -v /path/to/cache:/cache
  -v /path/to/media:/media
  –restart=always
  jellyfin/jellyfin:latest
  提示：为避免数据丢失，务必挂载 /config 与 /cache 等持久化卷。

四 设置自动更新

• Ubuntu/Debian（无人值守升级）
  • 安装无人值守升级：执行 sudo apt install unattended-upgrades -y。
  • 启用自动更新：执行 sudo dpkg-reconfigure --priority=low unattended-upgrades，按向导启用。
  • 说明：该方式会随系统安全与常规更新一起升级 Jellyfin（前提是已添加官方仓库）。
• CentOS/RHEL（Cron 脚本）
  • 创建更新脚本（示例）：
    #!/bin/bash
    sudo yum update jellyfin -y
    sudo systemctl restart jellyfin
  • 赋权并加入定时任务：
    chmod +x /usr/local/bin/update_jellyfin.sh
    (crontab -l ; echo “0 2 * * * /usr/local/bin/update_jellyfin.sh >> /var/log/jellyfin_update.log 2>&1”) | crontab -
  • 说明：上述示例为每天 02:00 自动更新并记录日志，可按需调整频率。

五 常见问题与回滚

• 升级失败或异常：优先查看日志（如 journalctl -u jellyfin 与容器日志），必要时回滚到上一版本或恢复备份。
• 版本验证：始终用 jellyfin --version 确认当前运行版本。
• 升级策略：生产环境建议先在测试环境验证，或采用滚动升级与备份策略，降低风险。