Debian下Jellyfin更新需要注意什么

Debian下Jellyfin更新的注意事项

1. 确认安装来源：优先使用官方仓库

Jellyfin的官方Debian仓库提供了最新的稳定版本及依赖项，建议通过官方仓库安装/更新，而非手动下载deb包（除非官方仓库无对应版本）。若未添加官方仓库，需先执行以下步骤：

• 导入GPG密钥：wget -O - https://repo.jellyfin.org/debian/jellyfin_team.gpg.key | sudo apt-key add -（旧版本Debian可能需要，新版本可能已集成）；
• 添加仓库源：echo "deb [arch=$(dpkg --print-architecture)] https://repo.jellyfin.org/debian $(lsb_release -c -s) main" | sudo tee /etc/apt/sources.list.d/jellyfin.list；
• 更新软件包列表：sudo apt update。

2. 更新前的准备工作

• 备份数据：更新前务必备份Jellyfin的配置文件（默认路径/var/lib/jellyfin/config）和媒体库元数据（如数据库、海报等），避免更新过程中出现意外导致数据丢失；
• 检查依赖兼容性：确保系统已安装Jellyfin所需的依赖（如ffmpeg、libssl等），可通过sudo apt install ffmpeg libssl1.1（根据系统版本调整）安装缺失依赖；
• 停止Jellyfin服务：更新前停止服务以减少冲突，命令：sudo systemctl stop jellyfin。

3. 执行更新操作

• 常规更新（通过官方仓库）：
  运行sudo apt update同步软件包列表，再执行sudo apt upgrade jellyfin升级到最新版本。若提示“无法升级”，可尝试sudo apt full-upgrade（解决依赖冲突）；
• 手动安装deb包（非仓库情况）：
  若需手动安装特定版本的deb包，下载后运行sudo dpkg -i jellyfin_*.deb jellyfin-ffmpeg_*.deb，若出现依赖错误，执行sudo apt -f install自动修复。

4. 更新后的验证与配置

• 启动服务并设置开机自启：更新完成后，启动Jellyfin服务：sudo systemctl start jellyfin，并设置为开机自启：sudo systemctl enable jellyfin；
• 检查服务状态：通过sudo systemctl status jellyfin确认服务是否正常运行（显示“active (running)”即为成功）；
• 访问Web界面验证：打开浏览器输入http://服务器IP:8096（默认端口），登录后台检查版本号及功能是否正常；
• 恢复配置（若有修改）：若更新前修改过配置文件，需对比备份文件与当前文件的差异，手动恢复自定义设置（如端口、媒体库路径等）。

5. 特殊场景：Docker用户的注意事项

若通过Docker安装Jellyfin，更新步骤与原生安装不同：

• 停止并删除旧容器：docker stop jellyfin && docker rm jellyfin；
• 拉取最新镜像：docker pull jellyfin/jellyfin；
• 重新创建容器：使用之前的挂载卷（-v /jellyfin/config:/config、-v /jellyfin/media:/media）启动新容器，确保数据不丢失。
  需注意：Docker更新不会自动修改容器内的配置，若镜像有配置变更，需手动调整。

6. 常见问题规避

• GPG密钥过期：若遇到“GPG签名验证失败”，需重新导入最新密钥（参考官方文档）；
• 依赖冲突：若apt upgrade报依赖错误，优先使用sudo apt -f install修复，切勿强制覆盖；
• 版本回滚：若更新后出现问题，可通过sudo apt install jellyfin=版本号回滚到指定版本（需提前查询可用版本）。