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 放行。
