Ubuntu 下 Jellyfin 的更新策略与落地方案
一、策略选型
- 滚动跟随：启用 官方 APT 仓库，随系统补丁周期自动获取 Jellyfin 的新版本，适合大多数家庭与小型部署，获取功能与安全修复最快。
- 手动/半自动：通过 APT 定时升级或维护窗口升级，在可控时间重启服务，适合对稳定性有更高要求的场景。
- 容器化：使用 Docker 时，更新镜像标签或重建容器即可，回滚方便，适合需要快速回滚与隔离环境的部署。
二、前提准备
- 使用 官方 APT 仓库 管理 Jellyfin，确保能获取最新稳定版与安全修复；已安装则可直接通过 APT 升级。
- 更新前建议备份 Jellyfin 配置与数据库（如元数据、播放记录等），以便异常时快速回滚。
- 如依赖硬件解码，确认相关驱动（如 Intel 核显 VA-API）已就绪，避免升级后转码异常。
三、落地做法
- 滚动跟随（推荐）
- 确保已添加 Jellyfin 官方仓库 并更新索引后，系统常规升级会自动包含 Jellyfin；如需仅升级 Jellyfin，可执行：sudo apt install --only-upgrade jellyfin；升级后重启服务：sudo systemctl restart jellyfin。
- 定时/半自动
- 使用 unattended-upgrades 自动安装安全更新，或配置 cron 在维护窗口执行：sudo apt update && sudo apt install --only-upgrade jellyfin && sudo systemctl restart jellyfin；升级前可先执行 sudo apt list --upgradable | grep jellyfin 查看待升级版本。
- 容器化
- 拉取新镜像（如 jellyfin/jellyfin:latest 或指定版本标签），备份挂载的 配置/缓存/数据 目录后重建容器；出现异常可快速回滚到旧镜像标签。
四、回滚与验证
- 回滚
- APT：使用 apt install jellyfin=<版本> 降级到指定版本，随后重启服务；容器：切换到旧镜像标签并重建容器。
- 验证
- 执行 jellyfin --version 或在 Web 管理端查看 关于 页的版本号，确认升级或回滚是否生效。
五、注意事项
- 升级前备份 配置与数据库，并在可维护时段操作，避免中断正在进行的播放或入库任务。
- 升级后检查 转码与硬件解码 是否正常（如 Intel VA-API 可用：vainfo 检查）；必要时安装或修复相关驱动。
- 若使用 第三方仓库或插件，可能存在版本滞后或冲突，优先使用 官方仓库 与兼容的插件版本。
