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 运行用户可读；必要时核对配置与目录权限。
  以上策略可在不影响业务连续性的前提下，降低更新风险并提升可维护性。