CentOS 上 Jellyfin 的更新与维护指南
一 更新策略与环境准备
- 更新方式优先级：优先使用 YUM 仓库进行更新；如无仓库或需精确版本，使用 RPM 本地安装；容器化部署则直接 拉取新镜像。更新前务必备份配置与数据，并在变更窗口内执行。
- 系统与依赖：保持系统与依赖为较新稳定版本，按需安装 FFmpeg 等转码依赖，避免因依赖过旧导致兼容或性能问题。
- 平台建议：CentOS 7 已于 2024-06-30 停止技术服务支持，建议迁移至 CentOS Stream 8/9 或 Rocky Linux/AlmaLinux 8/9 以获得持续安全更新与更好的兼容性。
二 RPM 方式更新步骤
- 备份与检查：备份 /var/lib/jellyfin、/etc/jellyfin 及媒体库元数据；检查当前版本：jellyfin --version。
- 添加官方仓库（示例为 RHEL/CentOS 8，其他版本将 rhel/8 替换为对应版本号）：
sudo tee /etc/yum.repos.d/jellyfin.repo << EOF
[jellyfin]
name=Jellyfin Repository
baseurl=https://download.jellyfin.org/yum-repo/rhel/8/$basearch/
enabled=1
gpgcheck=1
gpgkey=https://download.jellyfin.org/yum/RPM-GPG-KEY-jellyfin
EOF
- 执行更新与重启：
sudo yum update jellyfin -y
sudo systemctl restart jellyfin
sudo systemctl enable jellyfin
- 验证：访问 http://服务器IP:8096，在控制台查看版本号确认更新成功。
- 离线 RPM 场景：下载最新 RPM 包后执行：sudo yum localinstall /path/to/jellyfin-*.rpm && sudo systemctl restart jellyfin。
三 Docker 与 Docker Compose 更新步骤
- Docker：
docker pull jellyfin/jellyfin:latest
docker stop jellyfin && docker rm jellyfin
docker run -d --name jellyfin -p 8096:8096 \
-v /path/to/config:/config -v /path/to/cache:/cache -v /path/to/media:/media \
–restart=always jellyfin/jellyfin:latest
- Docker Compose：
docker-compose pull
docker-compose down && docker-compose up -d
- 建议：生产环境避免使用 latest 标签，改为固定版本号以便可回滚；更新后核对控制台版本信息。
四 日常维护与稳定性优化
- 安全与访问控制：配置 firewalld 放行 8096（或自定义端口）；按需调整 SELinux 策略，避免阻断 Jellyfin 访问媒体与配置目录。
- 转码与性能：安装并保持 FFmpeg 为较新版本；在控制台启用硬件加速（如 Intel Quick Sync/QSV），合理设置 MaxConcurrentSessions 与缓存策略，降低 CPU/内存压力。
- 资源与健康：定期监控 CPU/内存/磁盘 I/O，清理过期缓存与日志；为关键目录设置监控告警。
- 备份与回滚：定期备份 配置与数据库；RPM 场景可保留上一版本 RPM 以便回滚；容器场景使用不同 tag 的镜像进行版本回退。
五 常见问题与故障排查
- 依赖或冲突：执行 yum check-update、清理缓存 yum clean all；必要时检查 /var/log/yum.log 定位失败原因；若确认无关组件冲突，卸载冲突包后重试。
- 更新失败与兼容性：更新可能引入新依赖或触发冲突，确保网络与磁盘空间充足，必要时回滚到上一版本或指定版本。
- 服务异常：检查 systemctl status jellyfin 与日志输出，排查端口占用、权限与 SELinux 拒绝规则。
- 系统版本风险：CentOS 7 已 EOL，建议迁移至受支持的发行版以避免安全与依赖风险。