centos环境下jellyfin如何升级

CentOS环境下Jellyfin升级指南

一、升级前的准备工作

1. 备份关键数据：升级前务必备份Jellyfin的配置文件和媒体数据库，避免操作失误导致数据丢失。
   执行以下命令备份：

   sudo cp -r /var/lib/jellyfin /var/lib/jellyfin_backup  # 备份媒体库数据
   sudo cp -r /etc/jellyfin /etc/jellyfin_backup         # 备份配置文件
   sudo mysqldump -u root -p jellyfin > jellyfin_backup.sql  # 备份数据库（若使用MySQL）
   

二、方法一：使用YUM仓库升级（推荐，适用于大多数用户）

YUM仓库是Jellyfin官方提供的包管理工具，能自动处理依赖关系，升级过程更便捷。

1. 更新系统包：确保CentOS系统及现有软件包为最新版本，避免兼容性问题。

   sudo yum update -y
   

2. 添加Jellyfin官方YUM仓库：根据CentOS版本调整仓库地址（如CentOS 8对应rhel/8，CentOS 7对应rhel/7）。

   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/repo/RPM-GPG-KEY-jellyfin
   EOF
   

3. 安装/升级Jellyfin：使用YUM命令自动升级到最新版本（若已安装则会自动更新，未安装则直接安装）。

   sudo yum install jellyfin -y
   

4. 重启服务并验证：升级完成后重启Jellyfin服务，通过浏览器访问http://服务器IP:8096确认版本更新。

   sudo systemctl restart jellyfin
   sudo systemctl enable jellyfin  # 设置开机自启
   

三、方法二：手动下载并安装最新版本（适用于特定场景）

若YUM仓库无法满足需求（如版本延迟），可手动下载RPM包安装。

1. 备份数据：同方法一的步骤1。
2. 下载最新RPM包：访问Jellyfin官方发布页面，选择适用于CentOS的最新版本（如jellyfin-server-xxx.el8.x86_64.rpm、jellyfin-web-xxx.noarch.rpm）。
   示例命令（替换<version>为实际版本号）：

   wget https://download.jellyfin.org/releases/server/centos/8/x86_64/jellyfin-server-<version>.el8.x86_64.rpm
   wget https://download.jellyfin.org/releases/web/centos/8/x86_64/jellyfin-web-<version>.el8.noarch.rpm
   

3. 安装RPM包：使用rpm命令强制安装（--nodeps忽略依赖检查，若依赖问题严重建议先解决依赖）。

   sudo rpm -Uvh --nodeps jellyfin-server-<version>.el8.x86_64.rpm
   sudo rpm -Uvh --nodeps jellyfin-web-<version>.el8.noarch.rpm
   

4. 恢复数据与重启服务：将备份的配置文件复制回原目录，重启服务生效。

   sudo cp -r /etc/jellyfin_backup/* /etc/jellyfin/          # 恢复配置文件
   sudo systemctl restart jellyfin
   

四、方法三：使用Docker升级（适合容器化部署用户）

若通过Docker运行Jellyfin，升级过程更简单，无需处理系统依赖。

1. 备份数据卷：Docker数据通常存储在卷（Volume）中，备份对应的宿主机目录（如/srv/jellyfin/config、/srv/jellyfin/cache）。

   sudo cp -r /srv/jellyfin/config /srv/jellyfin/config_backup
   sudo cp -r /srv/jellyfin/cache /srv/jellyfin/cache_backup
   

2. 拉取最新镜像：从Docker Hub获取Jellyfin最新镜像。

   docker pull jellyfin/jellyfin:latest
   

3. 停止旧容器并启动新容器：替换旧容器，挂载原数据卷以保留配置和媒体文件。

   docker stop jellyfin
   docker rm jellyfin
   docker run -d --name jellyfin -p 8096:8096 --restart=always \
     -v /srv/jellyfin/config:/config -v /srv/jellyfin/cache:/cache \
     -v /media/movies:/media jellyfin/jellyfin:latest
   

4. 验证升级：访问http://服务器IP:8096确认新版本运行正常。

五、注意事项

1. 依赖问题处理：手动安装时若遇到依赖错误，可尝试sudo yum install -y <缺失依赖包>解决；若依赖冲突严重，建议使用YUM仓库或Docker方式升级。
2. 自定义配置兼容性：升级前检查自定义插件、主题或配置文件是否与新版本兼容，避免升级后功能异常。
3. Docker优势：容器化部署无需关心系统包依赖，升级更便捷，推荐新手或需要频繁升级的用户使用。
4. 官方支持提醒：Jellyfin官方已逐步停止对CentOS传统版本（如CentOS 7）的RPM包支持，建议升级到CentOS Stream或使用Docker以获取长期支持。