Jellyfin 是一个免费的开源媒体服务器 它将你的媒体库置于中心位置：你掌控一切，决定分享什么以及如何播放。无需强制账户、高级费用或侵入式遥测；理念清晰明确：“你的媒体，你的选择”，无论在家中还是在网络上，都能享受完全的隐私和控制。
在这份实用且非常完整的指南中 您将了解 Jellyfin 是什么、它的历史和许可证、支持的平台和客户端、Live TV、SyncPlay 和 DLNA 等主要功能、安装和配置过程的概述（包括 Docker 和 NAS）、与 Plex 和 Emby 的实际差异、具有 Dolby Vision 和 AV1 等新功能的特色版本，以及开发人员的详细信息（.NET、ffmpeg、Web 客户端和 API）以及用户对常见问题及其解决方案的体验。
Jellyfin 是什么以及它为何重要
果冻是 应用程序套件和媒体服务器 旨在使用客户端-服务器模型来组织、管理和共享您的数字文件（视频、音频、照片，甚至 EPUB 电子书）。服务器可在 Linux、Windows、macOS 或 Docker 容器中运行，客户端可在手机、平板电脑、智能电视、媒体播放器、游戏机或直接在浏览器中运行。
与专有替代品不同，例如 丛 或 Emby，Jellyfin 是 100%免费软件 （GPLv2），无需订阅或付费墙功能，也无需第三方身份验证。它可在独立的内联网上完美运行，无需依赖外部服务，并可为您网络上的 DLNA 和 Chromecast 设备提供内容。
Jellyfin 的历史、许可证和理念
该项目诞生于 8 年 2018 月 XNUMX 日，是 Emby 的一个分支当时社区（包括联合创始人 Andrew Rabert 和 Joshua Boniface）对其开放开发终止做出了反应。第一个版本于 30 年 2018 月 2019 日发布，并从 10.0.0 年 XNUMX 月开始采用专有版本控制系统，从 XNUMX 版本开始，并持续进行开发。
GPLv2 许可证确保代码保持自由 并且社区可以审核、改进和重新分发，这种方法也体现在隐私方面：没有“隐藏议程”，没有跟踪，也没有强制使用自己的媒体的帐户，这是许多用户比免费增值模式更看重的东西。
平台、生态系统和客户
Jellyfin 真正跨平台：Linux、Windows、macOS 和 Docker 上的服务器；Android、iOS 和 iPadOS、Amazon Fire TV、Android TV 和 Fire TV、Roku、Xbox One 和 Series X/S、带有 webOS 的 LG 电视、桌面应用程序（Jellyfin Media Player）以及可通过浏览器访问的 Web 界面的客户端。
还有可与 Kodi 集成的附加组件和插件。在某些情况下，甚至支持非官方的旧版 Emby 客户端（随着代码的差异，支持程度会越来越低）。默认访问使用端口 8096 上的 HTTP 和 8920 上的 HTTPS，通过适当的配置即可实现本地和远程访问。
与众不同的关键特性
- 电视直播和录制：如果添加必要的硬件/服务，Jellyfin 可以收看直播电视并管理录制，而不受第三方许可证施加的频道限制。
- Chromecast 和 DLNA：您可以将内容投射到 Chromecast 设备，并将内容流式传输到兼容 DLNA 的播放器。从 Jellyfin 10.9 开始，DLNA 已作为插件进行管理，保留了其功能，但将其移至“附加组件”部分。
- 同步播放：自 10.6.0 版本起，多个用户可以同步查看相同的内容，非常适合远程小组会议。
- EPUB 电子书和媒体片段- 添加了 EPUB 阅读，并在最近的版本中进行了改进，例如媒体片段（例如视频文件中的章节），以实现更精确的导航。
- 无付费墙：无需订阅即可使用转码、自定义抓取工具、IPTV 播放列表播放（通过 Xteve 或 HDHomeRun）和其他高级功能。
官方 Android 应用程序和移动体验
官方 Android 应用程序是服务器的天然伴侣：您需要运行 Jellyfin 服务器，然后您可以从应用程序中播放您的库、将内容发送到 Chromecast、通过友好的界面查看您的收藏以及使用 Android Auto 听音乐（仅限在线）。
“你的媒体，你的条件”这一座右铭在移动领域具有现实意义：无需帐户或跟踪，可直接访问您的收藏，并在支持该格式时提供强大的本地播放支持，最大限度地减少不必要的转码。
安装和入门（PC、Docker 和 NAS）
模式是服务器-客户端：首先，您需要安装服务器，然后从一个或多个客户端进行连接。在官方网站上，您可以找到适用于 Linux、Windows、macOS 和 Docker 的安装程序，社区也维护着适用于各种 NAS 的软件包。
QNAP NAS 和便捷的快捷方式：有些用户直接从 App Center 使用 .qpkg（例如，来自 GitHub 的 pdulvp 的 .qpkg）在 QNAP 上安装 Jellyfin，从而像任何其他 NAS 应用程序一样使用图标和启动来加快部署速度。
如果你使用 Emby，请小心使用 8096 端口Jellyfin 和 Emby 默认使用 8096，因此如果它们在同一台机器上运行，打开 Jellyfin 时很可能会看到 Emby 服务器。请更改其中一个的端口以避免冲突。
初始设置向导：启动 Jellyfin Server 时，选择语言，创建用户（最好避免使用“admin”并使用强密码）并定义您的库，指示它们是电影、连续剧、音乐等，元数据语言和您的国家/地区，以便正确分类。
外部访问和端口：首先，最好禁用外部访问和自动端口打开；一旦完成所有设置，请考虑仅在必要时公开 8096/8920，并采取适当的安全措施。
文件和抓取工具的组织：井然有序
Jellyfin 奖励订单，减少意外与 Plex 对混乱名称“宽容”不同，Jellyfin 的命名规范更清晰，尤其是在剧集方面。“剧集/第二季/剧集 S2E02.mp01”的结构可以避免命名问题，并加快识别速度。
如果触及，则重命名；如果没有触及，则自定义虽然重命名可能很繁琐，但 Jellyfin 允许您使用自定义抓取工具并手动编辑元数据而无需付费，而其他平台则隐藏在其高级计划后面。
性能、转码和播放质量
本地播放感觉流畅且强劲：从 Plex 迁移的用户经常会注意到，当支持该格式时，初始负载更轻，缓冲更少，从而避免了不必要的转码。
转码是免费的，但需要消耗资源如果您的 NAS 或服务器配置一般，实时转码可能会不堪重负。请在“播放”>“转换”中启用硬件加速，并在硬件允许的情况下尝试 HEVC 和 AV1，并相应地调整您的预期。
插件、IPTV 和扩展生态系统
官方附加组件库提供关键部分：DLNA（现已作为插件），与 Infuse、Kodi、NextPVR、Trakt 等集成。虽然目录并非无限，但基本涵盖了所有内容，而且社区可以贡献第三方存储库，而无需使用官方存储库。
无需付费的IPTV列表Jellyfin 可以使用 Xteve 或 HDHomeRun 作为中介播放 IPTV；设置需要比 Kodi 多一点的工作，但一旦设置好流，它就会无缝集成到您的库中。
安全与隐私
无强制账户、无遥测、无第三方Jellyfin 不会将您的数据发送到外部服务器，并且可以在您的网络内运行而不会公开。不过，请使用强密码，并仔细考虑是否真的需要打开外部端口。
带有“cookie 墙”的论坛和网络Reddit 等社区资源可能会显示有关 cookie 和类似技术的通知；这不是 Jellyfin 的一部分，但在浏览这些平台上的支持线程时值得注意。
开发：编译、贡献和调试 Jellyfin
服务器存储库位于 GitHub 并使用 .NET（目前编译需要 SDK 9.0）。您还需要 ffmpeg，并且可以在任何主流操作系统上使用 Visual Studio 2022 或 VS Code 进行开发（FreeBSD 除外，目前仍不受支持）。
Web 客户端与后端分离：服务器默认向 Web 客户端提供静态文件，但这些文件不包含在代码库中。您可以通过三种方式获取它们：从 Azure DevOps 流水线下载完成的版本、从 jellyfin-web 代码库编译它们，或从现有的服务器安装中复制它们。
启动和调试：在 Visual Studio 中，打开解决方案并按 F5。在 VS Code 中，打开 repo 文件夹，安装推荐的扩展，然后按 F5。在命令行中，输入“dotnet run”，或编译并运行二进制文件（Linux/macOS 上为 ./jellyfin，Windows 上为 jellyfin.exe）。
单独托管 Web 客户端：使用“–nowebclient”标志或“JELLYFIN_NOWEBCONTENT=true”变量。有一个“Jellyfin.Server (nowebcontent)”启动配置文件。请注意，如果 Web 客户端已断开连接，则安装向导将无法运行。
API 和测试API 文档位于服务器端口上的“/api-docs/swagger/index.html”。单元测试使用“dotnet test”运行，并且是 Azure 中 CI 管道的一部分。
Codespaces 和开发容器：创建环境时，加载扩展程序可能需要 20-30 秒（日志中显示 .NET 7.x）。如果您从外部访问，请将端口标记为公共端口。首次访问时可能会出现登录屏幕；请重新加载该屏幕以重定向到向导。目前有“nowebclient”容器变体，以及预装 ffmpeg6 的容器变体（启动器“ghcs .NET Launch (nowebclient, ffmpeg)”）。
真实体验：客户端的字幕和缓存
iOS 上的字幕不同步或缺失一些用户反映，在启用嵌入式字幕或 SRT 的情况下，iPhone 上同步失败或字幕无法加载，但在其他客户端（网页、Tizen、PC Media Player）上却可以正常播放。团队通常会通过更新来改进这个问题，但尝试不同的字幕容器和设置是个好主意。
切换服务器或更新时出现缓存故障连接到新服务器或更新仍链接到旧服务器的应用程序后，界面可能会因缓存损坏而无法呈现。在PC上，可以通过清除播放器缓存来修复此问题；在iPhone上，重新安装应用程序是最直接的解决方案。一个常见的请求是希望“重置应用程序”按钮也能清除网页缓存。
如何在日常生活中使用 Jellyfin
无论是在客厅还是在路上：访问您的媒体库、继续播放上次中断的内容、发送至 Chromecast 或智能电视，或使用 Android Auto 聆听音乐（请记住，这是在线模式）。如果您启用直播电视，则可以将频道和录制内容集成到您的观看体验中。
从浏览器和桌面网页客户端功能强大，适用于 Windows、macOS 和 Linux 的 Jellyfin Media Player 提供加速功能和便捷的键盘快捷键。此外，如果您更喜欢 Kodi 或 Infuse 的前端功能，还可以将其与 Kodi 或 Infuse 结合使用。
避免 Jellyfin 带来的麻烦的良好做法
- 保持服务器更新：除了新功能（例如杜比视界 HDR 或 AV1）之外，还有客户端错误修复、抓取工具改进和后端优化。
- 照顾好图书馆清晰的结构、一致的命名以及使用正确语言的元数据可以节省时间。您可以利用“播放”>“转换”选项来平衡质量和资源消耗。
- 带头插件只安装你用到的。DLNA 插件、Trakt 同步、Kodi/Infuse 集成以及 NextPVR 电视都是不错的选择；其余部分则需要进行控制测试。
Jellyfin 技术兼容性和其他说明
用 C# 编写并基于 .NETJellyfin 已将其 Web 前端迁移至独立系统，以应对 SQL 后端和多服务器高可用性场景。默认情况下，它以 8096/8920 端口公开，Swagger API 可帮助集成或自动化任务。
提供多种语言 并拥有一个活跃的社区，负责维护翻译（通过本地化平台）、主题和图标包。GitHub 项目除了服务器之外，还组织了许多子项目，并欢迎大家为社区提供指南和标准方面的贡献。
HTPC 生态系统使其与 Plex、Kodi 和 Emby 并驾齐驱 作为家庭影院的核心选项，兼容机顶盒和智能电视系统。您可以在 Docker 中运行它，并根据您的基础架构进行部署。
如果您今天正在寻找无需支付订阅费的控制、隐私和权力Jellyfin 是一个全面的选择：平台灵活，能够直播电视、插件和转码，并得到不断完善和扩展项目的社区支持。
