Jellyfin 是一款开源媒体服务器系统，专门用于高效组织、管理和流式传输个人媒体内容，包括视频、音乐和照片等资源。它支持跨多种设备访问，使用户能够轻松构建专属的家庭媒体中心。作为 Emby 和 Plex 等专有解决方案的替代品，Jellyfin 通过专用服务器将媒体内容分发到终端用户设备。该项目最初基于 Emby 的 3.5.2 版本开发，并已迁移至 .NET Core 框架，以实现全面的跨平台兼容性。
体验官方演示版本：
https://demo.jellyfin.org/stable/web/
安装步骤详解
使用 Docker Compose 部署
通过以下 Docker Compose 配置可以快速部署 Jellyfin 服务：
services:
jellyfin:
image: nyanmisaka/jellyfin:latest
container_name: jellyfin
ports:
- 8096:8096
volumes:
- /vol1/1000/docker/jellyfin/config:/config
- /vol1/1000/docker/jellyfin/cache:/cache
- /vol1/1000/docker/jellyfin/media:/media
environment:
- PUID=0
- PGID=0
- TZ=Asia/Shanghai
devices:
- /dev/dri:/dev/dri
restart: always
参数配置说明
- 8096 端口（必需）：用于 HTTP 通信的服务端口
- /config 目录（必需）：存储服务配置文件的位置
- /cache 目录（可选）：用于缓存文件的存储路径
- /media 目录（可选）：媒体文件的主存储目录
- PUID 和 PGID（可选）：设置运行服务的用户和组标识
- TZ 时区（可选）：配置系统时区设置
- /dev/dri 设备（可选）：启用 GPU 硬件加速功能
基本使用指南
在浏览器中输入 http://NAS的IP:8096 即可访问 Jellyfin 管理界面。
选择首选语言后，点击"下一步"继续设置流程。
创建管理员账户信息，完成后点击"下一步"。
初次设置建议暂不添加媒体库，后续可再进行详细配置。
设置元数据抓取的语言偏好，点击"下一步"继续。
保持默认网络设置，直接点击"下一步"。
完成基础设置后，系统会显示设置完成的确认界面。
使用刚才设置的管理员账号和密码登录系统。
进入主界面后，由于尚未配置媒体库，页面会显示为空状态。
控制面板功能详解
点击左上角菜单按钮展开功能选项。
选择"控制面板"进入系统管理界面。
查看服务器信息，当前运行的 Jellyfin 版本为 10.10.7。
监控活动设备数量和媒体使用情况统计。
可以自定义修改服务器名称标识。
支持多用户访问时，可创建额外的用户账户。
提示说明
媒体库和播放设置将在后续章节单独介绍，其他设置通常保持默认即可。计划任务功能允许用户合理设置运行时间，如果希望硬盘长时间休眠不被频繁唤醒，可以将任务安排在相同时间段执行。
媒体库配置与管理
这是一个典型的影音媒体库结构，分为电影和电视剧两个主要类别（资源数量较多时可进一步细分）。
点击添加媒体库（如果界面持续加载，尝试重启服务解决）。
选择正确的内容类型（重要），显示名称可根据需要自定义。
指定存放电影的文件夹位置，支持多文件夹同时添加。
配置建议
以下设置项无需逐一详细说明，参考示例配置即可。如果文件夹命名不规范，建议启用相应选项进行整理。
元数据抓取器推荐仅选择 TMDB 来源。
元数据存储方式选择 Nfo 格式，图片获取器选用 TMDB 和屏幕截图功能（后者可选）。
将元数据集中存储在同一目录，便于后续管理和迁移。
其他选项根据实际需求配置，初期可保持默认，后续按需调整。
完成设置后，媒体库自动开始扫描过程。
返回控制面板，可能发现元数据获取异常（通常因网络连接问题无法访问 TMDB）。
通过网络代理重新抓取后即可正常显示海报信息（具体方法不展开说明）。
查看影片详情页面，显示完整的元数据信息。
演员信息也能正常显示（需要稳定的网络连接支持）。
所有抓取的元数据文件都保存在统一目录中。
快速指南
以下简要介绍电视剧媒体库的添加流程。注意内容类型应选择"节目"分类。
参考图示进行基本参数配置。
按照示例完成文件夹设置。
元数据抓取器建议仅选用 TMDB，避免多源冲突。
启用 Nfo 元数据存储功能。
参照示意图设置高级选项。
勾选这两个重要选项。
确认无误后点击"确定"保存设置。
首页立即刷新显示新添加的内容。
元数据抓取完整准确（识别失败通常因文件名不规范导致）。
每集电视剧都包含详细信息，显著提升观看体验。
元数据文件保存在对应的剧集文件夹中。
硬件转码功能配置
此功能需要设备配备 GPU，通常集成显卡即可满足需求，主要在外网播放场景中使用。
Intel 核显建议选择 QSV 或 VAAPI，ARM 处理器选用 RKMPP（其他处理器类型请参考官方文档）。
个人测试表明 QSV 编码效率较高，仅使用核显时无需指定特定设备。
编码选项可保持默认或全选（AV1 需显卡支持，多数设备不支持），此处使用默认设置。
需要色彩映射功能的用户可启用此选项。
设备性能较弱时可适当限制转码参数，确认后点击"保存"。
4K 视频播放时正常触发转码流程。
任务管理器显示 GPU 使用率变化证实硬件加速生效。
综合评估与总结
由于个人使用习惯，我对 Jellyfin 的实际应用经验有限，仅能提供基础使用指导，更高级的功能需要用户自行探索。我个人更常使用 Emby 解决方案，Jellyfin 的主要优势在于完全免费，但界面美观度稍逊于 Emby。值得注意的是，Jellyfin 和 Emby 的元数据完全兼容，后期迁移成本极低。
综合推荐指数：⭐⭐⭐（设备兼容性优秀）
使用体验评分：⭐⭐⭐（免费方案中表现良好）
部署难度评估：⭐⭐⭐（配置过程适中）