Linux Jellyfin需要哪些依赖项

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），并正确配置密钥与权限。
    这些网络与权限项影响外部访问、设备发现与媒体读取的稳定性。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！