ubuntu jellyfin更新指南

Ubuntu 下 Jellyfin 更新指南

一 更新前准备

• 确认安装方式：常见为 APT 原生安装、Docker 容器运行，少数为 Snap。不同方式更新路径不同。
• 系统与仓库准备：执行 sudo apt update && sudo apt upgrade -y，保持系统与依赖为最新。
• 版本与服务检查：查看当前版本 jellyfin --version，服务状态 sudo systemctl status jellyfin。
• 备份关键数据：优先备份 /config 配置目录 与 媒体库元数据，以便出现异常可快速恢复。
• 权限与网络：确保媒体目录对 Jellyfin 运行用户可读；如经反向代理或防火墙，放行 8096/tcp。

二 APT 原生安装更新步骤

• 导入官方仓库（若尚未添加，推荐新版签名方式）：
  sudo mkdir -p /etc/apt/keyrings
  curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg
  echo “deb [signed-by=/etc/apt/keyrings/jellyfin.gpg] https://repo.jellyfin.org/ubuntu $(lsb_release -cs) main” | sudo tee /etc/apt/sources.list.d/jellyfin.list
  sudo apt update
• 执行更新：
  • 仅升级 Jellyfin：sudo apt install --only-upgrade jellyfin -y
  • 随系统一起升级：sudo apt upgrade -y
• 使更新生效：sudo systemctl restart jellyfin
• 验证版本：jellyfin --version
• 旧版密钥方式（如系统仍保留旧源，可兼容）：
  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

三 Docker 部署更新步骤

• 拉取新镜像：docker pull jellyfin/jellyfin:latest
• 方式 A（docker-compose）：
  docker compose pull
  docker compose up -d --remove-orphans
• 方式 B（docker run 示例）：
  docker stop jellyfin && docker rm jellyfin
  docker run -d --name jellyfin \ –restart unless-stopped \ -p 8096:8096 \ -v /path/to/config:/config \ -v /path/to/media:/media \ jellyfin/jellyfin:latest
• 说明：更新通常通过“拉取新镜像 + 重建容器”完成；如使用 Portainer，可在界面中完成停止、拉取、重建与重启。

四 其它安装方式与验证

• Snap 安装：更新 sudo snap refresh（或 sudo snap refresh jellyfin）；如使用系统服务，重启可用 sudo systemctl restart --user jellyfin。
• 版本验证：更新后执行 jellyfin --version 确认版本号；服务巡检可用 sudo systemctl status jellyfin 与 journalctl -u jellyfin -b --no-pager -n 200 查看最新日志。

五 回滚与日常维护

• 回滚策略：
  • APT：降级到指定版本 sudo apt install jellyfin=<版本号>；或使用 Timeshift 进行系统快照回滚。
  • Docker：保留上一个稳定标签（如 jellyfin/jellyfin:10.9.0），异常时回退该标签重建容器。
• 自动化与安全更新：启用 unattended-upgrades 处理系统与安全更新；如需自动更新 Jellyfin 本体，可结合定时任务定期执行 apt install --only-upgrade jellyfin -y（务必先做好备份与回滚预案）。
• 硬件加速与依赖：按需校验 Intel 核显 驱动（如安装 intel-media-va-driver-non-free vainfo 并执行 vainfo），或在 NVIDIA 环境下配置驱动与容器工具链并在 Jellyfin 中启用硬件解码。
• 常见问题排查：权限不足导致扫描/播放失败时，核对 媒体目录 与 /config 权限；反向代理与防火墙需确保 8096/tcp 放行。