Ubuntu 上 Jellyfin 的更新与维护指南
一 更新路径与准备
sudo apt update && sudo apt upgrade -ysudo systemctl status jellyfinjellyfin --version二 APT 原生安装更新步骤
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key \
| sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg
echo "deb [signed-by=/etc/apt/keyrings/jellyfin.gpg] https://repo.jellyfin.org/ubuntu $(lsb_release -cs) main" \
| sudo tee /etc/apt/sources.list.d/jellyfin.list
sudo apt update
sudo apt install --only-upgrade jellyfin -y # 仅升级 Jellyfin
# 或:sudo apt upgrade -y # 随系统一起升级
sudo systemctl restart jellyfin
jellyfin --version三 Docker 部署的更新步骤
# 拉取最新镜像
docker pull jellyfin/jellyfin:latest
# 方式A:docker-compose
docker compose pull
docker compose up -d --remove-orphans
# 方式B:docker run(示例)
docker stop jellyfin && docker rm jellyfin
docker run -d --name jellyfin \
--restart unless-stopped \
-p 8096:8096 \
-v /path/to/config:/config \
-v /path/to/media:/media \
jellyfin/jellyfin:latest
四 日常维护与故障排查
服务与版本巡检(建议每周):
sudo systemctl status jellyfin
sudo journalctl -u jellyfin -b --no-pager -n 200
jellyfin --version
权限与媒体库:
硬件加速(按需):
sudo apt install intel-media-va-driver-non-free vainfo -y
vainfo
网络与反向代理:
sudo ufw allow 8096/tcp五 自动化与回滚建议
自动安全更新(系统层面):
sudo apt install unattended-upgrades -y && sudo dpkg-reconfigure unattended-upgradesapt install --only-upgrade jellyfin -y,并在升级前做好备份与回滚预案。回滚与应急:
sudo apt install jellyfin=<版本号> 降级到指定版本;或利用 Timeshift 对系统进行快照回滚。jellyfin/jellyfin:10.9.0),出现异常时回退到该标签重建容器。