Jellyfin 是一款开源媒体服务器系统,专为组织、管理和流式传输个人媒体内容(如视频、音乐、照片等)而设计。它支持多种设备访问,让用户能够轻松搭建专属的家庭媒体中心。作为专有软件如 Emby 和 Plex 的免费替代方案,Jellyfin 通过专用服务器向终端设备提供媒体内容。该项目起源于 Emby 的 3.5.2 版本,现已移植到 .NET Core 框架,实现全面跨平台兼容性,适用于各种操作系统环境。
您可以通过官方演示站点体验 Jellyfin 的功能:https://demo.jellyfin.org/stable/web/
Jellyfin 安装过程详解
使用 Docker Compose 进行部署是推荐方法。以下配置代码适用于大多数 NAS 环境:
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 硬件加速
Jellyfin 界面使用教程
在浏览器中输入 http://NAS的IP:8096
即可访问 Jellyfin 初始化界面。
选择首选语言后点击“下一步”按钮继续。
设置管理员账户的用户名和密码,确保安全性,然后点击“下一步”。
此步骤建议暂时跳过媒体库添加,后续可详细配置,直接点击“下一步”。
选择元数据刮削的默认语言(例如中文),点击“下一步”确认。
保持远程访问设置默认值,点击“下一步”继续。
完成基础设置后,系统将显示配置成功界面。
输入管理员账户凭据登录 Jellyfin 仪表盘。
初始首页无内容显示,因媒体库尚未配置。
管理控制面板功能
点击左上角菜单图标展开侧边栏选项。
选择“控制面板”进入服务器管理界面。
查看服务器信息,例如当前 Jellyfin 版本为 10.10.7。
监控活动设备数量和媒体使用统计。
自定义服务器名称以增强识别性。
支持多用户访问,可创建额外账户。
媒体库和播放功能将在后续章节单独说明。其他设置如网络或编码可保留默认值。计划任务模块需注意:若需硬盘长时间休眠,可统一设置任务执行时段以减少唤醒频率。
媒体库配置方法
媒体库通常分为电影和电视剧等类别(数量庞大时可进一步细分)。
点击“添加媒体库”启动设置流程(若界面卡顿,尝试重启服务)。
选择内容类型(如“电影”),并自定义显示名称。
指定电影文件存储路径,支持多文件夹选择。
文件夹名称混乱时启用自动整理选项。
刮削器建议仅选用 TMDB 以确保数据一致性。
元数据存储勾选“用 Nfo 保存”,图片获取器推荐 TMDB 和屏幕抓取(非必需)。
集中存储刮削数据至单一文件夹,便于管理和迁移。
其他高级选项如自动更新可暂不启用,后续按需调整。
设置完成后,媒体库自动开始扫描操作。
返回面板可见初始刮削失败(网络问题导致 TMDB 连接中断)。
启用网络优化后重新刮削,海报数据正常显示。
点击媒体条目查看完整元数据信息。
演员详情页需稳定网络支持方可加载。
刮削数据统一存储于指定文件夹内。
电视剧媒体库添加时内容类型需选择“节目”。
参考示例配置进行参数设置。
优化文件夹和元数据选项参照图示。
刮削器仅勾选 TMDB 避免冲突。
确保 Nfo 元数据存储启用。
按推荐设置图片和高级选项。
启用剧集排序和元数据刷新功能。
确认无误后点击“确定”保存配置。
首页刷新显示新增电视剧内容。
刮削数据完整显示(名称不规范可能导致失败)。
每集详情页提升观影体验。
元数据文件存储于对应媒体文件夹。
硬件转码配置指南
此功能需设备配备 GPU,核显通常足够,主要适用于外网播放场景。
Intel 核显选择 QSV 或 VAAPI,ARM 处理器选用 RKMPP(其他架构需验证)。
QSV 效率较高,核显无需指定设备。
编码器选项可全选或默认(AV1 需显卡支持),此处保留默认值。
HDR 色彩映射按需启用。
设备性能不足时可限制并发转码,完成后点击“保存”。
测试 4K 视频转码功能正常运作。
任务管理器显示 GPU 利用率变化验证效果。
整体使用评估与总结
Jellyfin 提供基础部署和使用指导,高级功能需用户自定义。个人常用 Emby,其界面更优,但 Jellyfin 免费特性突出。两者元数据兼容,迁移成本低。综合评估:设备兼容性优异(⭐⭐⭐),免费体验尚可(⭐⭐⭐),部署难度中等(⭐⭐⭐)。