Linux上Jellyfin如何更新
小樊
38
2025-11-28 23:51:37
Linux 上 Jellyfin 更新指南
一 更新前准备
- 备份关键数据:配置文件目录(通常为 /var/lib/jellyfin、/etc/jellyfin)、缓存目录(如 /var/cache/jellyfin)以及媒体库元数据。可使用 rsync/tar 等方式做快照备份。
- 查看当前版本:执行 jellyfin --version;同时确认服务状态 systemctl status jellyfin,确保更新前服务可用。
- 选择维护窗口:更新过程中会有短暂不可用,建议在低峰时段进行,并确保有回滚方案(如保留旧版本包、快照或容器镜像)。
二 发行版仓库更新
- Ubuntu/Debian
- 更新索引并升级:执行 sudo apt update && sudo apt upgrade -y,已安装时会自动升级 jellyfin 及其依赖。
- 仅升级 Jellyfin:执行 sudo apt install --only-upgrade jellyfin -y。
- 重启服务:执行 sudo systemctl restart jellyfin。
- 验证版本:执行 jellyfin --version。
- CentOS/RHEL(使用官方 YUM 仓库)
- 导入仓库(以 RHEL/CentOS 8 为例,其他版本将路径中的 8 替换为对应主版本):
- 创建文件 /etc/yum.repos.d/jellyfin.repo,内容:
- [jellyfin]
- name=Jellyfin Repository
- baseurl=https://download.jellyfin.org/yum-repo/rhel/8/$basearch/
- enabled=1
- gpgcheck=1
- gpgkey=https://download.jellyfin.org/yum-repo/rhel/8/RPM-GPG-KEY-jellyfin
- 更新与重启:执行 sudo yum update jellyfin -y 后 sudo systemctl restart jellyfin。
- 验证版本:执行 jellyfin --version。
三 Docker 部署更新
- 拉取最新镜像:执行 docker pull jellyfin/jellyfin:latest。
- 停止并删除旧容器:执行 docker stop <container_name> 与 docker rm <container_name>(注意先记录挂载的卷与端口映射)。
- 以原有参数重新创建容器(示例):
- docker run -d --name <container_name>
-p 8096:8096
-v /srv/jellyfin/config:/config
-v /srv/jellyfin/cache:/cache
-v /movies:/media
–restart=always
jellyfin/jellyfin:latest
- 说明:上述示例映射了 /config、/cache 与媒体目录 /media,请按你的实际路径调整;更新完成即可通过 http://服务器IP:8096 访问。
四 自动更新与回滚建议
- Ubuntu/Debian 自动安全更新
- 启用无人值守升级:执行 sudo apt install unattended-upgrades -y,按需配置 /etc/apt/apt.conf.d/50unattended-upgrades,将 jellyfin 加入自动升级名单,可在维护时段自动应用安全更新。
- CentOS/RHEL 使用 Cron 定时更新
- 创建更新脚本(示例):
- #!/bin/bash
sudo yum update jellyfin -y
sudo systemctl restart jellyfin
- 赋权并加入计划任务(每天 02:00 执行):
- chmod +x /usr/local/bin/update_jellyfin.sh
- echo “0 2 * * * /usr/local/bin/update_jellyfin.sh >> /var/log/jellyfin_update.log 2>&1” | sudo tee /etc/cron.d/jellyfin-update
- 回滚与风险控制
- 仓库包:使用包管理器回滚(如 yum downgrade jellyfin 或 apt install jellyfin=<旧版本>)。
- Docker:保留旧镜像标签(如 jellyfin/jellyfin:10.8.x),回滚时直接改用旧镜像启动。
- 通用:更新前做好配置与数据备份,更新后第一时间在控制台与日志中核验服务状态与版本信息。