centos上jellyfin的更新和维护指南

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，建议迁移至受支持的发行版以避免安全与依赖风险。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！