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（具体以发行版与版本为准）。
- 安装步骤简述：
- 下载并安装 DEB：dpkg -i jellyfin_*.deb
- 如有缺依赖，执行修复安装：apt -f install
- 若计划使用系统级 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 完成初始化设置。
