阅读量:7
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=版本号回滚到指定版本（需提前查询可用版本）。