ubuntu jellyfin更新指南
小樊
32
2025-12-28 16:07:10
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 放行。