Ubuntu上Jellyfin的更新方法

Ubuntu 上 Jellyfin 的更新方法

一 更新前准备

• 确认安装方式：常见为 APT 原生安装 与 Docker 容器运行，不同方式更新路径不同。
• 备份关键数据：建议先备份 /etc/jellyfin（配置）与媒体库元数据目录（默认在 ~/.config/jellyfin 或你挂载的配置路径），以防意外。
• 检查运行状态与版本：
  • 查看服务：sudo systemctl status jellyfin
  • 查看版本：jellyfin --version
• 更新索引与依赖：sudo apt update && sudo apt upgrade -y
  以上准备可显著降低更新风险并确保升级后服务可用。

二 APT 原生安装更新步骤

• 导入官方仓库（若尚未添加，推荐新版签名方式）：
  • 创建密钥环并导入 GPG：
    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
    以上流程适用于 Ubuntu 20.04/22.04/24.04 等使用 APT 的版本。

三 Docker 部署的更新步骤

• 拉取最新镜像：
  • Docker Compose：docker compose pull
  • 或手动：docker pull jellyfin/jellyfin:latest
• 重建容器（保持挂载卷不变，确保数据与配置不丢失）：
  • Docker Compose：docker compose up -d --remove-orphans
  • 或手动：
    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
• 验证：访问 http://服务器IP:8096 确认版本与功能正常。
  提示：若使用 Portainer，可在界面中完成停止、拉取、重建与重启操作。

四 自动化与回滚建议

• 自动安全更新（系统层面）：
  • 安装并启用无人值守升级：sudo apt install unattended-upgrades -y && sudo dpkg-reconfigure unattended-upgrades
  • 如需自动更新 Jellyfin 本体，可结合定时任务定期执行：sudo apt install --only-upgrade jellyfin -y（升级前务必做好备份）。
• 回滚与应急：
  • APT：可降级到指定版本：sudo apt install jellyfin=<版本号>；或使用 Timeshift 做系统快照回滚。
  • Docker：保留上一个稳定镜像标签（如 jellyfin/jellyfin:10.9.0），异常时回退到该标签重建容器。
• 故障排查要点：
  • 查看服务日志：sudo journalctl -u jellyfin -b --no-pager -n 200
  • 权限与媒体库：确保媒体目录对 jellyfin 运行用户可读；必要时核对配置与目录权限。
    以上策略可在不影响业务连续性的前提下，降低更新风险并提升可维护性。