centos下jellyfin更新教程

CentOS下Jellyfin更新教程

更新Jellyfin前，请务必完成数据备份，避免操作失误导致数据丢失。以下是两种常用更新方法及详细步骤：

一、使用YUM仓库更新（推荐，适用于大多数用户）

YUM仓库更新是最便捷的方式，可自动解决依赖问题并保持系统更新同步。

1. 备份关键数据

# 备份配置文件
sudo cp -r /etc/jellyfin /etc/jellyfin-backup
# 备份媒体库数据（可选但建议）
sudo cp -r /var/lib/jellyfin /var/lib/jellyfin-backup

2. 更新系统包

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

sudo yum update -y

3. 添加/更新Jellyfin官方YUM仓库

若未添加过Jellyfin仓库，或需要更新仓库信息，执行以下命令（根据CentOS版本调整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/RPM-GPG-KEY-jellyfin
EOF

4. 安装/更新Jellyfin

通过YUM安装或更新到最新版本：

sudo yum install jellyfin -y
# 或仅更新Jellyfin（若已安装）
sudo yum update jellyfin -y

5. 重启服务并验证

# 重启Jellyfin服务
sudo systemctl restart jellyfin
# 设置开机自启（可选但推荐）
sudo systemctl enable jellyfin
# 验证版本
jellyfin --version
# 访问Web界面（默认端口8096）确认更新成功

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

若YUM仓库未及时同步最新版本，或需要安装测试版，可选择手动下载安装。

1. 备份数据

步骤同方法一，确保配置文件和媒体库数据安全。

2. 下载最新RPM包

访问Jellyfin官方下载页面，选择适用于CentOS的RPM包（如jellyfin-server、jellyfin-web），使用wget下载：

wget https://download.jellyfin.org/builds/jellyfin-<version>-centos8-x86_64.rpm

将<version>替换为最新版本号（如10.10.0）。

3. 安装RPM包

使用rpm命令安装下载的包（若已安装旧版本，-Uvh会自动升级）：

sudo rpm -Uvh jellyfin-*.rpm

4. 替换旧版本文件（若解压安装）

若下载的是压缩包（如.tar.gz），需解压并替换旧版本目录：

# 解压到/opt目录
sudo tar -xvzf jellyfin-*.tar.gz -C /opt
# 备份旧版本
sudo mv /opt/jellyfin /opt/jellyfin-old
# 移动新版本到目标目录
sudo mv /opt/jellyfin-* /opt/jellyfin

5. 恢复数据并重启服务

# 恢复配置文件和媒体库数据
sudo cp -r /etc/jellyfin-backup/* /etc/jellyfin/
sudo cp -r /var/lib/jellyfin-backup/* /var/lib/jellyfin/
# 重启服务
sudo systemctl restart jellyfin
# 验证更新

三、使用Docker更新（可选，适用于容器化部署）

若通过Docker运行Jellyfin，更新流程更简单：

1. 拉取最新镜像

docker pull jellyfin/jellyfin:latest

2. 停止并删除旧容器

docker stop jellyfin
docker rm jellyfin

3. 运行新容器

保持数据卷挂载路径一致（避免数据丢失）：

docker run -d \
  --name jellyfin \
  -p 8096:8096 \
  --restart=always \
  --privileged=true \
  -v /path/to/config:/config \
  -v /path/to/cache:/cache \
  -v /path/to/media:/media \
  jellyfin/jellyfin:latest

将/path/to/config、/path/to/cache、/path/to/media替换为实际数据目录。

注意事项

• 依赖问题：若更新过程中提示缺少依赖（如ffmpeg），可通过sudo yum install -y <dependency>安装。
• 兼容性检查：更新前确认自定义插件、皮肤与新版本兼容，避免功能异常。
• Docker用户：建议使用docker-compose管理容器，简化更新流程（修改docker-compose.yml中的镜像版本后执行docker-compose up -d）。

通过以上步骤，可顺利完成CentOS系统下Jellyfin的更新。若遇到问题，可参考Jellyfin官方文档或社区论坛寻求帮助。