Linux Jellyfin更新和维护指南

一、更新前的准备工作

1. 备份关键数据：更新前务必备份Jellyfin的配置文件（通常位于/var/lib/jellyfin或/config）和媒体库元数据（如海报、简介），防止更新过程中出现意外导致数据丢失。
2. 检查系统兼容性：确保Linux发行版处于支持状态（如Ubuntu 20.04及以上、CentOS 7及以上），并满足Jellyfin的最低硬件要求（推荐2GB RAM+2GHz CPU）。
3. 更新系统软件包：更新系统本身的软件包，避免因系统库版本过低导致Jellyfin更新失败或运行异常。

二、不同发行版的更新步骤

（一）Ubuntu/Debian（APT包管理）

1. 添加Jellyfin官方仓库

• Ubuntu 22.04/20.04：

  wget -O - https://repo.jellyfin.org/ubuntu/jellyfin_team.gpg.key | sudo apt-key add -
  echo "deb [arch $(dpkg --print-architecture)] https://repo.jellyfin.org/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list
  

• Ubuntu 18.04/16.04：将$(lsb_release -cs)替换为对应版本代号（如bionic、xenial）。

2. 安装/更新Jellyfin

• 首次安装：

  sudo apt update && sudo apt install jellyfin -y
  

• 更新现有安装：

  sudo apt update && sudo apt install --only-upgrade jellyfin -y
  

3. 重启服务并验证

sudo systemctl restart jellyfin
jellyfin --version  # 确认版本已更新

（二）CentOS/RHEL（YUM/DNF包管理）

1. 添加Jellyfin官方仓库

sudo yum install -y epel-release
sudo yum install -y https://repo.jellyfin.org/releases/server/centos/jellyfin.repo

2. 安装/更新Jellyfin

• 首次安装：

  sudo yum install jellyfin -y
  

• 更新现有安装：

  sudo yum update jellyfin -y
  

3. 重启服务并验证

sudo systemctl restart jellyfin
jellyfin --version  # 确认版本已更新

（三）Docker部署（推荐）

若使用Docker运行Jellyfin，更新流程更简单：

1. 拉取最新镜像：

   docker pull jellyfin/jellyfin:latest
   

2. 停止并删除旧容器（保留数据卷）：

   docker stop jellyfin && docker rm jellyfin
   

3. 启动新容器（确保-v挂载路径与之前一致）：

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

4. 验证更新：通过浏览器访问http://服务器IP:8096，进入系统设置查看版本。

三、维护建议

1. 依赖管理

确保关键依赖（如ffmpeg）为最新版本，支持媒体转码和硬件加速：

• Ubuntu：sudo apt install ffmpeg-jellyfin -y
• CentOS：sudo yum install ffmpeg -y。

2. 硬件加速优化

启用硬件加速（如Intel Quick Sync、NVIDIA NVENC）降低CPU占用：

• Intel平台：安装intel-media-va-driver-non-free，在Jellyfin Web界面→播放→转码中开启硬件加速。
• NVIDIA平台：安装nvidia-driver-XXX（替换为适合的驱动版本）和nvidia-cuda-toolkit，同样在转码设置中开启NVENC。

3. 资源监控与优化

• 限制并发连接：在/etc/jellyfin/config.json中调整MaxConcurrentSessions（如家庭使用设为50），避免过多连接导致服务器卡顿。
• 启用缓存：在config.json的Cache section中设置Enabled: true和Size: 1024（1GB缓存），减少媒体文件重复读取。

4. 日志与故障排查

• 查看日志：使用journalctl -u jellyfin -f实时查看Jellyfin日志，定位播放失败、转码错误等问题。
• 常见问题处理：
  • 媒体封面不显示：进入Jellyfin容器安装中文字体（如apt install fonts-wqy-microhei），重启容器。
  • 无法硬解视频：检查显卡驱动是否安装正确，确认Jellyfin转码设置中启用了对应的硬件加速选项。

四、注意事项

• 避免强制中断更新：更新过程中不要关闭终端或服务器，防止软件包损坏。
• 定期检查安全公告：关注Jellyfin官方GitHub仓库或邮件列表，及时应用安全补丁（如CVE修复）。
• 插件管理：仅安装官方或可信来源的插件，避免使用未经验证的插件影响稳定性。