Linux 更新 Jellyfin 到最新版本
一 通用准备
- 备份重要数据：优先备份 /var/lib/jellyfin、/etc/jellyfin、以及你的 媒体库与数据库，避免更新异常导致数据丢失。
- 确认安装方式：常见为 APT（Debian/Ubuntu）、YUM/DNF（RHEL/CentOS/Fedora）、Docker/Portainer。不同方式升级路径不同。
- 维护窗口：升级期间会重启服务，建议在低峰时段进行，并确保有回滚方案（如快照/备份）。
二 基于 Debian 或 Ubuntu 的更新
- 更新索引并升级系统包：
sudo apt update && sudo apt upgrade -y
- 若尚未添加官方仓库，先导入 GPG 并添加源（以 Ubuntu 20.04/22.04 为例）：
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
- 执行升级（两种等效方式）：
sudo apt install jellyfin -y
或仅升级已安装包：sudo apt install --only-upgrade jellyfin -y
- 重启服务并验证版本：
sudo systemctl restart jellyfin
jellyfin --version
完成后通过 http://服务器IP:8096 访问，确认服务正常与版本号更新。
三 基于 RHEL、CentOS 或 Fedora 的更新
- 导入官方仓库（以 RHEL/CentOS 8 为例，其他版本将 rhel/8 替换为你的系统代号）：
sudo tee /etc/yum.repos.d/jellyfin.repo << EOF
[jellyfin]
name=Jellyfin Repository
baseurl=https://download.jellyfin.org/yum-repo/rhel/8/$basearch/
enabled=1
gpgcheck=1
gpgkey=https://download.jellyfin.org/yum/RPM-GPG-KEY-jellyfin
EOF
- 更新系统并升级 Jellyfin：
sudo yum update -y
sudo yum update jellyfin -y
- 如使用 RPM 本地包 升级：
sudo yum localinstall /path/to/jellyfin-*.rpm -y
- 重启服务并验证：
sudo systemctl restart jellyfin
jellyfin --version
访问 http://服务器IP:8096 确认运行状态与版本。
四 使用 Docker 或 Portainer 的更新
- 拉取最新镜像：
docker pull jellyfin/jellyfin:latest
- 停止并删除旧容器（请先确认你的卷挂载路径，如 /config、/cache、/media）：
docker stop jellyfin && docker rm jellyfin
- 以原有参数重新创建容器（示例）：
docker run -d --name jellyfin -p 8096:8096 \
-v /path/to/config:/config -v /path/to/cache:/cache -v /path/to/media:/media \
jellyfin/jellyfin:latest
- 使用 Portainer：在容器列表中选择 Jellyfin，执行 Pull 最新镜像后 Recreate 容器（保持原有卷和环境变量不变）。更新完成后通过 http://服务器IP:8096 验证。
五 验证与回滚建议
- 验证：
- 命令行：jellyfin --version 查看是否为最新版本号。
- 界面：访问 http://服务器IP:8096，在 仪表盘 > 关于 中核对版本与服务器状态。
- 常见问题与回滚：
- 升级失败可先检查日志：sudo journalctl -u jellyfin -xe；必要时用备份恢复 /config 与数据库。
- 若使用 Docker，务必确保 卷挂载 正确，避免数据被覆盖；回滚时重新运行旧镜像并挂载原卷即可。
- 不建议跨多版本一次性大跳升级，生产环境建议先在测试环境验证或在维护窗口操作。
