Linux Jellyfin更新与维护指南

一、更新前的准备工作

1. 备份关键数据：更新前务必备份Jellyfin的配置文件（通常位于/var/lib/jellyfin或/config）和媒体数据，防止更新过程中出现意外导致数据丢失。
2. 检查系统要求：确保系统满足Jellyfin的最低需求（推荐2GB RAM、2GHz CPU），避免因硬件不足导致更新后运行不稳定。
3. 确认安装方式：明确Jellyfin的安装方式（YUM/APT包管理、Docker容器、Snap包），不同方式的更新步骤差异较大。

二、基于包管理的更新（Debian/Ubuntu为例）

1. 添加Jellyfin官方仓库（可选但推荐）

若未添加官方仓库，需先导入GPG密钥并添加仓库文件，以确保获取最新版本：

# 导入GPG密钥
wget -O - https://repo.jellyfin.org/ubuntu/jellyfin_team.gpg.key | sudo apt-key add -
# 添加仓库文件（根据Ubuntu版本调整lsb_release -cs）
echo "deb [arch=$(dpkg --print-architecture)] https://repo.jellyfin.org/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list

2. 更新系统包列表

sudo apt update  # 更新包列表，确保获取最新版本信息

3. 升级Jellyfin

• 升级所有已安装软件包（包括Jellyfin）：

  sudo apt upgrade -y
  

• 仅升级Jellyfin（推荐）：

  sudo apt install --only-upgrade jellyfin -y
  

4. 重启服务并验证

sudo systemctl restart jellyfin  # 重启Jellyfin服务使更新生效
jellyfin --version  # 验证版本是否更新

三、基于包管理的更新（CentOS/RHEL为例）

1. 添加EPEL仓库（可选但推荐）

EPEL仓库提供额外的依赖包，确保Jellyfin正常运行：

sudo yum install -y epel-release

2. 更新Jellyfin

• 使用YUM包管理器：

  sudo yum update jellyfin -y
  

• 手动下载RPM包（若官方仓库无最新版本）：
  从Jellyfin官网下载对应版本的RPM包，然后执行：

  sudo yum localinstall jellyfin-*.rpm -y
  

3. 重启服务并验证

sudo systemctl restart jellyfin
jellyfin --version

四、Docker部署的更新方法

若使用Docker运行Jellyfin，更新步骤更简单：

1. 拉取最新镜像：

   docker pull jellyfin/jellyfin:latest
   

2. 停止并删除旧容器：

   docker stop <container_name>  # 替换为实际容器名
   docker rm <container_name>
   

3. 运行新容器：
   保持数据卷挂载路径一致（如/config、/data），避免数据丢失：

   docker run -d \
     --name jellyfin \
     -p 8096:8096 \
     -v /path/to/config:/config \
     -v /path/to/data:/data \
     jellyfin/jellyfin:latest
   

4. 重启服务：

   sudo systemctl restart docker  # 若Docker设置为开机自启，此步可省略
   

五、维护建议

1. 启用自动更新（Ubuntu为例）：
   通过unattended-upgrades包实现自动更新，减少手动操作：

   sudo apt install unattended-upgrades -y
   sudo dpkg-reconfigure --priority=low unattended-upgrades
   

2. 定期监控系统资源：
   使用htop（CPU/内存）、nvidia-smi（GPU）等工具监控资源使用情况，避免因资源不足导致服务中断。

3. 管理插件与依赖：

   • 仅安装必要的插件（如Jellyfin Plugin Manager），避免插件冲突；
   • 定期检查依赖包版本（如ffmpeg），确保与Jellyfin版本兼容。

4. 处理常见冲突：

   • 依赖冲突：使用yum check-update或apt-cache policy检查冲突，通过yum remove <package>或apt remove <package>卸载冲突包；
   • 配置文件冲突：更新前备份配置文件，若更新后出现配置错误，可将备份文件覆盖回原路径。

5. 确保系统长期支持：
   若使用CentOS 7（已于2024年6月停止支持），建议升级到CentOS Stream、Rocky Linux或AlmaLinux，以获得持续的安全更新和技术支持。