Jellyfin

Jellyfin 是一款完全免费、无付费功能墙的开源媒体服务器,基于 .NET(C#)与 FFmpeg 构建,允许用户在本地或远程设备上串流自己收藏的电影、电视剧、音乐、有声书和照片。它于 2018 年底从 Emby 项目分叉而来,至今由社区以 GPL-2.0 许可证维护,不存在任何闭源组件或收费订阅层。

起源与发展

Emby 在 2018 年 11 月将核心代码转为闭源并引入付费 Premiere 订阅后,社区中一批贡献者在公开的最后一个开源版本(3.5.2)基础上建立了 Jellyfin 分叉。最初的几个月主要精力集中于剔除闭源依赖、重建构建系统和建立独立的插件生态。2019 年发布 10.3 版本后,Jellyfin 逐渐形成稳定的发布节奏,每隔数月发布一个大版本。至 2024 年的 10.9 版本,Jellyfin 已具备完整的 SyncPlay 同步播放、歌词显示、有声书管理、DLNA 服务端等功能,客户端覆盖 Web、Android、iOS/tvOS、Roku、Kodi 插件、Android TV 等主流平台。项目通过 OpenCollective 接受捐款,无商业化压力,所有功能对所有用户完全开放。

核心功能

• 媒体库管理:支持电影、电视剧(含剧集元数据自动刮削)、音乐、照片、有声书、图书等多类型媒体,通过 NFO 文件或在线元数据源(TheMovieDB、TheTVDB、MusicBrainz、AniDB 等)自动匹配封面、简介、演员信息。
• 转码与直播:利用 FFmpeg 进行软件或硬件转码,将高码率视频实时转为客户端可播放的分辨率和码率;支持 HLS 直播源(IPTV M3U 列表)与 HDHomeRun 网络调谐器,提供电子节目表(EPG)和录制功能。
• SyncPlay 同步播放:允许多个远程用户同步播放同一内容,播放、暂停、跳转均由服务器协调广播给所有参与者,适合异地朋友一同观影。
• 多用户与家长控制:可创建多个用户账号并独立维护播放进度、收藏和评分,为未成年账号设置内容分级限制、访问时段和禁止访问特定媒体库。
• 歌词与音乐体验:音乐播放器支持逐行歌词显示(LRC 格式或在线源),播放队列管理,部分客户端支持均衡器调节。
• 字幕支持:内嵌字幕直接渲染,支持外挂 SRT/ASS/SSA 字幕,可配置 OpenSubtitles 自动搜索并下载字幕文件。
• 插件生态:官方维护多个插件(Bookshelf 图书库、AniDB 元数据源、OpenSubtitles 字幕),社区提供的第三方插件可通过自定义仓库 URL 安装。
• DLNA 与投屏:内置 DLNA 服务端,可将媒体投送到支持 DLNA/UPnP 的电视或音响;同时支持 Chromecast 投屏协议。

技术架构

Jellyfin 服务端以 .NET 8 编写,跨平台运行于 Linux、Windows 和 macOS。数据库层使用 SQLite 存储元数据、用户数据和媒体库索引,图片缩略图缓存存储于文件系统。API 层基于 ASP.NET Core 提供 RESTful 接口,同时提供 WebSocket 连接用于推送播放状态变更通知给客户端,保证多设备间的播放进度实时同步。

转码管道调用 FFmpeg 二进制:Jellyfin 根据客户端上报的设备能力(DeviceProfile)决定是否转码及目标格式。对于支持直播流(Direct Play)的设备,文件直接发送不经 FFmpeg;仅需容器转换(Direct Stream)时只改封装格式而不重编码;两者均不满足时才进行完整转码。硬件加速方面支持 Intel QSV、NVIDIA NVENC/NVDEC、AMD AMF、VideoToolbox(macOS)、V4L2(ARM 设备),需在管理后台播放设置中选择并确保 FFmpeg 已编译相关支持。插件系统通过 .NET 程序集动态加载实现,安装后重启服务生效。

部署与配置

Jellyfin 提供 Docker 镜像(jellyfin/jellyfin,支持 amd64/arm64/arm/v7)、各发行版软件仓库包(Debian/Ubuntu/Fedora/Arch)以及 Windows 安装程序。Docker 部署时需挂载媒体目录(只读)和配置目录(读写),并按需挂载硬件设备节点(如 /dev/dri 用于 Intel/AMD GPU 硬件解码)。反向代理时需正确配置 WebSocket 代理(Upgrade 和 Connection 头),Nginx 官方文档有对应示例。

不同平台的硬件转码配置要点有所差异:Intel QSV 需安装对应的 VA-API 驱动并将容器用户加入 render 组;NVIDIA NVENC 需在宿主机安装 NVIDIA Container Toolkit 并在 Docker 参数中声明 GPU 设备;树莓派等 ARM 设备使用 V4L2 解码时需挂载 /dev/video10 等设备节点。首次启动向导会引导配置媒体库路径、元数据语言和管理账号,配置完成后即可开始扫描媒体库,首次扫描大型库会消耗较长时间和较高 CPU。

与 Emby、Plex 的对比

与 Emby 相比,Jellyfin 全功能免费,移动端播放无时长限制,录制和硬件加速均无需订阅;Emby 的这些功能需要 Premiere 授权。与 Plex 相比,Jellyfin 不依赖云账户,完全本地化运行,用户数据不经过第三方服务器,隐私性更强;Plex 的界面打磨程度和对智能电视原生 App 的覆盖广度通常优于 Jellyfin,但核心功能同样需要 Plex Pass 订阅。Jellyfin 的短板主要在于 iOS 官方客户端(Swiftfin)长期处于 beta 阶段,以及部分高阶功能(如杜比视界元数据映射、HDR 色调映射)的支持进度晚于商业竞品。

优缺点小结

• 优点:完全免费无付费墙,100% 开源可审计,无需注册外部账户,隐私数据完全自控,支持硬件加速方案丰富,SyncPlay 无额外费用。
• 缺点:iOS 客户端成熟度相对较低;元数据刮削偶有失准需手动修正;部分品牌智能电视无原生 Jellyfin 应用,需借助 Kodi 或浏览器访问;大型媒体库首次扫描耗时较长;社区驱动节奏导致某些功能迭代周期不可预期。

值得一提的是,Jellyfin 的字幕处理能力在开源媒体服务器中较为突出。服务端可在转码时将外挂字幕硬烧入视频流,确保不支持外部字幕的客户端(如部分智能电视浏览器)也能正常显示字幕。对于 ASS/SSA 格式的复杂样式字幕(常见于动漫压制组发布的版本),Jellyfin 支持在软件转码时保留字幕样式渲染,而不是退化为纯文本显示。此外,Jellyfin 10.8 版本后引入了服务器端 HDR 转 SDR 的色调映射功能,使不支持 HDR 的播放设备也能获得较为准确的色彩还原,而非一片过曝的白色画面。对于家庭用户而言,Jellyfin 的家长控制功能已足够完善:管理员可以为儿童账号设置内容评级上限(如仅允许观看评级为 PG 以下的内容)、限制每日使用时段、隐藏特定媒体库(如将成人内容库设为对儿童账号不可见)。这些功能在无需付费的情况下即可使用,是 Jellyfin 相较于 Emby 和 Plex 的重要优势之一。