Linux 上 Jellyfin 的依赖项与安装要点
一、核心运行依赖
- 媒体处理：FFmpeg（视频转码/封装/字幕）。多数发行版的官方仓库会随 Jellyfin 提供专用的 jellyfin-ffmpeg 包；若使用容器，镜像通常已内置。手动安装时请确保 ffmpeg 与 ffprobe 在 PATH 中可用。
- 国际化与字体：libicu（Unicode/全球化支持）、fontconfig（字体配置与查找）。
- 系统基础：常见的基础运行库由发行版元包自动拉取（glibc、libssl 等），通常无需单独处理。
以上依赖在不同发行版上的具体包名可能略有差异，但上述组件是最核心的必备项。
二、发行版与安装方式对应的依赖与要点
- Ubuntu/Debian
- 导入官方仓库前准备：apt-transport-https、ca-certificates、curl。
- 安装命令示例：sudo apt update && sudo apt install jellyfin。
- 说明：官方 APT 源会处理绝大多数依赖；若需要手动补齐，可优先确保 ffmpeg/jellyfin-ffmpeg 可用。
- CentOS/RHEL（以 7 为例）
- 常见基础依赖：libicu、fontconfig。
- 转码组件：FFmpeg（可从静态构建安装，确保 ffmpeg/ffprobe 在 PATH）。
- 安装方式：可用 yum/dnf 本地安装 RPM，或配置官方仓库后安装；启动服务：systemctl start jellyfin && systemctl enable jellyfin。
- Docker
- 依赖由镜像提供，无需在宿主机预装 Jellyfin 本体依赖；但宿主机需安装 Docker。
- 运行示例：docker run -d --name jellyfin -p 8096:8096 -v /path/config:/config -v /path/cache:/cache -v /path/media:/media jellyfin/jellyfin:latest。
以上要点涵盖 Ubuntu/Debian、CentOS 与 Docker 的常见依赖与安装路径，便于在不同环境下快速落地。
三、硬件加速相关依赖（可选）
- Intel Quick Sync Video
- 宿主机需安装 intel-media-va-driver-non-free（或系统提供的 iHD 驱动）。
- 容器需映射 /dev/dri/renderD128 与 /dev/dri/card0，并在 Jellyfin 控制台启用硬件加速。
- 其他平台
- NVIDIA NVENC/AMF 等需相应驱动与运行时（宿主机安装并由容器映射/使用）。
硬件加速能显著降低转码 CPU 占用，启用前请确认驱动与设备节点可用。
四、网络与权限依赖（可选但常见）
- 防火墙放行端口：8096/TCP（HTTP）、8920/TCP（HTTPS）、1900/UDP（DLNA）、5353/UDP（mDNS/Bonjour）。
- 文件系统与挂载
- 本地目录：确保运行用户对媒体目录与配置/缓存目录具备读写权限。
- 对象存储挂载（如 S3）：需 s3fs-fuse 及其编译依赖（gcc、fuse-devel、libcurl-devel、libxml2-devel、make、openssl-devel），并正确配置密钥与权限。
这些网络与权限项影响外部访问、设备发现与媒体读取的稳定性。