Ubuntu 下更新 Jellyfin 的标准流程
一、快速更新步骤
- 更新软件包索引并升级系统：
- sudo apt update
- sudo apt upgrade
- 仅升级 Jellyfin 软件包（已安装时推荐）：
- sudo apt install --only-upgrade jellyfin
- 重启服务以应用更新：
- sudo systemctl restart jellyfin
- 验证版本：
- jellyfin --version
以上命令适用于已添加 Jellyfin 官方仓库 的环境；如尚未添加，请先完成仓库配置（见下节）。
二、确保使用官方仓库
- 导入 GPG 公钥：
- wget -O - https://repo.jellyfin.org/ubuntu/jellyfin_team.gpg.key | sudo apt-key add -
- 添加 APT 源（自动匹配架构与发行版代号）：
- echo “deb [arch=$(dpkg --print-architecture)] https://repo.jellyfin.org/ubuntu $(lsb_release -cs) main” | sudo tee /etc/apt/sources.list.d/jellyfin.list
- 更新索引后再次执行升级：
- sudo apt update
- sudo apt install --only-upgrade jellyfin
以上为 Ubuntu 20.04/22.04 等常见版本的通用做法；添加仓库后即可通过 APT 正常接收更新。
三、设置自动更新
- 方式 A（推荐）：使用无人值守升级
- 安装并启用：
- sudo apt install unattended-upgrades
- sudo dpkg-reconfigure --priority=low unattended-upgrades
- 在自动更新配置中勾选或添加更新源前缀（如 jellyfin），使其纳入安全/常规自动升级范围。
- 方式 B：使用系统定时任务定期执行
- 创建定时任务（示例：每日 3:00 升级 Jellyfin）：
- echo “0 3 * * * root apt update && apt install --only-upgrade jellyfin -y && systemctl restart jellyfin” | sudo tee /etc/cron.d/jellyfin-upgrade
- 说明：方式 A 更安全可控；方式 B 简单直接，但升级时可能产生短暂服务中断，建议结合维护窗口使用。
四、常见问题与验证
- 升级后无法启动：查看服务状态与日志
- sudo systemctl status jellyfin
- journalctl -u jellyfin -b
- 升级后版本未变化：确认来源为官方仓库
- apt policy jellyfin
- 若显示的候选版本并非来自 repo.jellyfin.org/ubuntu，请检查并修正 /etc/apt/sources.list.d/jellyfin.list 中的源地址。
- 硬件解码相关：如为 Intel 核显，建议安装解码驱动并验证
- sudo apt install intel-media-va-driver-non-free
- vainfo -y
以上排障与验证步骤可帮助确认更新是否成功并处于可用状态。
