centos环境下jellyfin如何升级

CentOS环境下Jellyfin升级指南

一、升级前的准备工作

备份关键数据：升级前务必备份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官方提供的包管理工具，能自动处理依赖关系，升级过程更便捷。

更新系统包：确保CentOS系统及现有软件包为最新版本，避免兼容性问题。
```
sudo yum update -y
```

添加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

安装/升级Jellyfin：使用YUM命令自动升级到最新版本（若已安装则会自动更新，未安装则直接安装）。
```
sudo yum install jellyfin -y
```
重启服务并验证：升级完成后重启Jellyfin服务，通过浏览器访问http://服务器IP:8096确认版本更新。
```
sudo systemctl restart jellyfin
sudo systemctl enable jellyfin  # 设置开机自启
```

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

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

备份数据：同方法一的步骤1。
下载最新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
```

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

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

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

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

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

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

备份数据卷：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
```
拉取最新镜像：从Docker Hub获取Jellyfin最新镜像。
```
docker pull jellyfin/jellyfin:latest
```

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

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

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

五、注意事项

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