CentOS 上更新 Jellyfin 的关键注意事项
一 更新前准备
- 备份关键数据：至少备份 /etc/jellyfin（配置）、/var/lib/jellyfin（数据库与缓存），如有自建库可额外导出，例如 mysqldump -u root -p jellyfin > jellyfin_backup.sql。更新前停机可减少数据库写入风险。
- 确认部署方式与版本：区分 RPM 包 与 Docker 两种部署路径，后续步骤不同；记录当前 Jellyfin 版本 以便回退或比对。
- 检查可用空间与依赖：确保 /var 与根分区有足够空间；确认 FFmpeg 与系统依赖（如 libicu、fontconfig）可用，避免更新后转码或界面异常。
- 维护窗口与通知：选择低峰时段，提前告知家庭/团队用户，避免播放中断。
二 更新方式与要点
- RPM 仓库更新（推荐）：配置官方仓库后执行 yum update jellyfin，更新完成执行 systemctl restart jellyfin；如需全新安装可用 yum install jellyfin。仓库 baseurl 中的 $releasever 需与系统版本匹配（如 7/8）。
- 手动 RPM 更新：下载对应架构的最新 RPM 包，使用 yum localinstall /path/to/jellyfin-*.rpm 进行升级，随后重启服务。
- Docker 更新：先 docker pull jellyfin/jellyfin:latest（或指定具体版本），再 docker stop/rm 旧容器，按原参数重新 docker run（注意挂载 /config、/cache、/media 等卷，保持数据持久化）。
- 服务与自启：更新后确认 systemctl enable --now jellyfin 处于期望状态。
三 兼容性与回退
- 插件与自定义配置：升级前先检查插件与新版本 Jellyfin 的兼容性，必要时先禁用；更新后逐项启用验证。
- FFmpeg 与硬件加速：部分版本可能出现 FFmpeg 编解码或 Intel/VA-API 硬件加速异常，优先使用系统或官方推荐的 FFmpeg，并按需安装/更新驱动（如 i965-va-driver-shaders）。
- 系统版本适配：较旧的 CentOS 与大版本 Jellyfin 之间可能存在依赖或运行差异，若遇到启动失败、页面异常，优先核对仓库路径的 $releasever 与组件版本。
- 安全修复：留意更新日志中的 CVE 修复，例如 10.7.1 版本曾修复任意文件读取漏洞，遇到相关风险应尽快升级。
- 回退方案：RPM 可通过保留旧版本包或快照/备份进行回滚；Docker 回退到历史镜像标签并重启容器。
四 更新后验证与运维
- 访问与版本核对：打开 http://服务器IP:8096，在管理后台确认已升级到目标版本；必要时用 jellyfin --version 辅助核对。
- 功能与转码验证：抽查常见格式播放、外挂字幕、封面/演员信息加载，确认 FFmpeg 转码与硬件加速工作正常。
- 日志与告警：查看 journalctl -u jellyfin -b 是否有启动或运行错误；若异常，优先回看本次变更与插件。
- 防火墙与端口：确保 8096/8920 等端口在 firewalld 中放行，避免更新后无法访问。