ubuntu上jellyfin的更新和维护指南 - 问答

Ubuntu 上 Jellyfin 的更新与维护指南

一更新路径与准备

确认安装方式：常见为 APT 原生安装 与 Docker 容器运行。不同方式更新路径不同。
准备与检查：
- 更新索引并升级系统依赖：sudo apt update && sudo apt upgrade -y
- 查看服务状态：sudo systemctl status jellyfin
- 查看当前版本：jellyfin --version
- 建议先备份 Jellyfin 配置与媒体库元数据（见文末维护清单）。

二 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 部署的更新步骤

拉取新镜像并重建容器（示例，按你的 compose/运行方式调整）：

# 拉取最新镜像
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

说明：容器更新通常通过“拉取新镜像 + 重建容器”完成；若使用 Portainer，可在界面中完成停止、拉取、重建与重启。

四日常维护与故障排查

服务与版本巡检（建议每周）：

sudo systemctl status jellyfin
sudo journalctl -u jellyfin -b --no-pager -n 200
jellyfin --version

权限与媒体库：
- 确保媒体目录对 Jellyfin 运行用户可读（常见问题为权限不足导致扫描失败或无法播放）。
- 出现配置错误时，核对配置文件与目录权限，必要时从备份恢复默认后逐步迁移自定义设置。
硬件加速（按需）：
- Intel 核显：安装驱动并校验
```
sudo apt install intel-media-va-driver-non-free vainfo -y
vainfo
```
- NVIDIA 显卡：安装合适驱动与容器工具链，并在 Jellyfin 中启用硬件解码。
网络与反向代理：
- 防火墙放行：sudo ufw allow 8096/tcp
- 使用 Apache/Nginx 配置反向代理与 HTTPS（可用 Certbot 自动申请证书）。

五自动化与回滚建议

自动安全更新（系统层面）：
- 启用无人值守升级：sudo apt install unattended-upgrades -y && sudo dpkg-reconfigure unattended-upgrades
- 该方式主要处理系统与安全更新；如需自动更新 Jellyfin 本体，可结合定时任务定期执行 apt install --only-upgrade jellyfin -y，并在升级前做好备份与回滚预案。
回滚与应急：
- APT：使用 sudo apt install jellyfin=<版本号> 降级到指定版本；或利用 Timeshift 对系统进行快照回滚。
- Docker：保留上一个已知良好的镜像标签（如 jellyfin/jellyfin:10.9.0），出现异常时回退到该标签重建容器。
- 快速回滚执行清单：停止服务 → 回退版本/镜像 → 恢复配置与数据库 → 启动服务 → 验证版本与播放。

0 赞

0 踩