Linux系统如何更新Jellyfin
小樊
45
2025-12-24 13:53:52
Linux系统更新 Jellyfin 的实用步骤
一 更新前准备
- 备份关键数据:建议先备份 /config、/cache 以及媒体库元数据目录,避免意外丢失配置或缓存。
- 查看当前版本:执行 jellyfin --version 记录升级前后版本,便于回滚或排查。
- 选择维护窗口:尽量在业务低峰期操作,避免中断正在进行的播放或转码任务。
二 发行版仓库更新
- Ubuntu/Debian
- 更新索引并仅升级 Jellyfin:执行 sudo apt update && sudo apt install --only-upgrade jellyfin -y。
- 重启服务:执行 sudo systemctl restart jellyfin。
- 验证版本:执行 jellyfin --version。
说明:若已添加 Jellyfin 官方仓库,执行系统升级(如 apt upgrade)时也会自动升级 Jellyfin。
- CentOS/RHEL 或兼容发行版
- 通过仓库更新:执行 sudo yum update jellyfin -y(或 dnf update jellyfin -y)。
- 重启服务:执行 sudo systemctl restart jellyfin。
- 验证版本:执行 jellyfin --version。
说明:如未配置官方仓库,可先导入 RPMFusion 与 Jellyfin 仓库,再用包管理器升级。
三 Docker 部署的更新
- 拉取最新镜像:执行 docker pull jellyfin/jellyfin:latest。
- 停止并删除旧容器:执行 docker stop <container_name> && docker rm <container_name>。
- 使用原有卷与端口重新启动:
docker run -d --name <container_name>
-p 8096:8096
-v /path/to/config:/config
-v /path/to/cache:/cache
-v /path/to/media:/media
–restart=always
jellyfin/jellyfin:latest
提示:为避免数据丢失,务必挂载 /config 与 /cache 等持久化卷。
四 设置自动更新
- Ubuntu/Debian(无人值守升级)
- 安装无人值守升级:执行 sudo apt install unattended-upgrades -y。
- 启用自动更新:执行 sudo dpkg-reconfigure --priority=low unattended-upgrades,按向导启用。
- 说明:该方式会随系统安全与常规更新一起升级 Jellyfin(前提是已添加官方仓库)。
- CentOS/RHEL(Cron 脚本)
- 创建更新脚本(示例):
#!/bin/bash
sudo yum update jellyfin -y
sudo systemctl restart jellyfin
- 赋权并加入定时任务:
chmod +x /usr/local/bin/update_jellyfin.sh
(crontab -l ; echo “0 2 * * * /usr/local/bin/update_jellyfin.sh >> /var/log/jellyfin_update.log 2>&1”) | crontab -
- 说明:上述示例为每天 02:00 自动更新并记录日志,可按需调整频率。
五 常见问题与回滚
- 升级失败或异常:优先查看日志(如 journalctl -u jellyfin 与容器日志),必要时回滚到上一版本或恢复备份。
- 版本验证:始终用 jellyfin --version 确认当前运行版本。
- 升级策略:生产环境建议先在测试环境验证,或采用滚动升级与备份策略,降低风险。