Debian上Jellyfin需要哪些依赖

Debian 上 Jellyfin 的依赖与安装要点

一、通过 APT 仓库安装时的必备依赖

• 用于添加 HTTPS 源与导入 GPG 密钥的基础工具：apt-transport-https、ca-certificates、curl、gnupg。
• 添加仓库后，直接执行：sudo apt install jellyfin；仓库元数据会自动拉取并满足 Jellyfin 运行所需的其他运行时依赖。
• 说明：官方推荐使用仓库安装，因为仓库中包含多个与 Jellyfin 配套的依赖包，能减少手动处理依赖的工作量。

二、使用官方 DEB 包手动安装时的核心依赖

• 常见核心依赖包括：at、libsqlite3-0、libfontconfig1、libfreetype6、libssl1.x（具体以发行版与版本为准）。
• 安装步骤简述：
  1. 下载并安装 DEB：dpkg -i jellyfin_*.deb
  2. 如有缺依赖，执行修复安装：apt -f install
  3. 若计划使用系统级 FFmpeg，需另行安装；若使用官方提供的 jellyfin-ffmpeg 包，则与 Jellyfin 一并安装更省事。

三、转码与硬件加速相关依赖（可选但常用）

• 媒体转码通常依赖 FFmpeg。Jellyfin 既可使用系统 FFmpeg，也可使用官方打包的 jellyfin-ffmpeg（与 Jellyfin 一同从仓库安装更一致）。
• Intel 核显硬件加速（VA-API/iHD）：确保内核与驱动就绪，设备节点 /dev/dri/renderD128 可用，并将 jellyfin 用户加入 render 组：
  • 检查设备：ls -l /dev/dri
  • 加入组并重启服务：sudo usermod -aG render jellyfin && sudo systemctl restart jellyfin
• 其他平台（如 NVIDIA NVENC）需安装对应驱动与容器工具链（如使用 Docker 时）。

四、快速安装与验证步骤

• 更新索引并安装：sudo apt update && sudo apt install jellyfin
• 启动与开机自启：sudo systemctl start jellyfin && sudo systemctl enable jellyfin
• 验证运行状态：sudo systemctl status jellyfin
• 访问 Web 界面：打开浏览器访问 http://服务器IP:8096 完成初始化设置。