如何在Linux上更新Jellyfin

Linux 上更新 Jellyfin 的实用步骤

一、通用准备

• 备份关键数据：建议先备份 /var/lib/jellyfin（元数据与数据库）、/etc/jellyfin（配置）、以及你的媒体库与封面缓存目录，避免意外丢失。
• 查看当前版本：运行 jellyfin --version 记录升级前后版本，便于回滚或排查。
• 选择维护窗口：更新会重启服务，建议在低峰时段进行，并提前通知家庭/团队用户。

二、发行版仓库更新

• Ubuntu/Debian

  1. 更新索引并升级：sudo apt update && sudo apt upgrade -y
  2. 仅升级 Jellyfin：sudo apt install --only-upgrade jellyfin -y
  3. 重启服务：sudo systemctl restart jellyfin
  4. 验证版本：jellyfin --version 说明：若已添加官方仓库，以上命令即可将 Jellyfin 升级到仓库中的最新版本。

• CentOS/RHEL/Fedora（使用 RPM 仓库）

  1. 导入官方仓库（以 CentOS 8 为例，其他版本将路径中的 8 替换为你的主版本号）： sudo tee /etc/yum.repos.d/jellyfin.repo << EOF [jellyfin] name=Jellyfin Repository baseurl=https://download.jellyfin.org/yum/repo/centos/8/$basearch/ enabled=1 gpgcheck=1 gpgkey=https://download.jellyfin.org/yum/repo/RPM-GPG-KEY-jellyfin EOF
  2. 升级：sudo yum update jellyfin -y（或使用 dnf：sudo dnf upgrade -y jellyfin）
  3. 重启服务：sudo systemctl restart jellyfin
  4. 验证版本：jellyfin --version 说明：通过官方 YUM 仓库可简化升级流程并保持版本同步。

三、Docker 部署的更新

• 拉取最新镜像：docker pull jellyfin/jellyfin:latest
• 停止并删除旧容器（数据卷挂载保持不变）： docker stop jellyfin docker rm jellyfin
• 以原有参数重新创建容器（示例，请按你的实际挂载与端口调整）： docker run -d
  –name jellyfin
  -p 8096:8096
  -v /srv/jellyfin/config:/config
  -v /srv/jellyfin/cache:/cache
  -v /movies:/media
  –restart=always
  jellyfin/jellyfin:latest
• 验证：docker logs -f jellyfin 或访问 Web UI 查看版本号 说明：更新容器镜像后需重建容器；只要 /config 与 /cache 挂载正确，配置与数据库会保留。

四、设置自动更新与回滚建议

• 自动更新
  • Cron 脚本示例（CentOS，每天 02:00 更新并写日志）： #!/bin/bash sudo yum update jellyfin -y sudo systemctl restart jellyfin 赋权：chmod +x /path/to/update_jellyfin.sh 定时：crontab -e 添加 0 2 * * * /path/to/update_jellyfin.sh >> /var/log/jellyfin_update.log 2>&1
  • 也可使用 Ansible 统一管理多台服务器的 Jellyfin 升级与重启。
• 回滚与风险控制
  • 仓库包升级出错时，优先用包管理器回滚到上一版本（如 yum downgrade jellyfin 或 apt install jellyfin=<旧版本>），再核查问题。
  • 升级前确保已备份 /var/lib/jellyfin 与 /etc/jellyfin；升级后第一时间在 Web UI 检查播放、插件与硬件解码是否正常。