Docker 玩法

飞牛NAS部署Jellyfin媒体服务器完整教程

在众多媒体服务器方案中,Jellyfin 凭借完全开源、免费无限制、功能全面的特点,成为许多 NAS 用户搭建私人影音库的首选。今天,我们就来一步步教你在飞牛NAS(fnOS)上完成 Jellyfin 的部署与基础配置,让你轻松打造属于自己的流媒体平台。

准备工作

在开始之前,请确保你的飞牛NAS已经处于正常工作状态,并且能够访问互联网。建议提前准备好一个用于存放电影、电视剧、音乐等媒体文件的文件夹,例如在存储空间1下新建一个名为「media」的共享文件夹,并在其内部按类型建立子文件夹(如 movies、tvshows、music),这样后续刮削和管理会方便很多。

第一步:下载 Jellyfin 镜像

打开飞牛NAS的「Docker」应用,进入「镜像」页面,点击右上角的「拉取镜像」。在搜索框中输入 jellyfin/jellyfin,选择最新的稳定版本标签(通常为 latest),点击「拉取」按钮。等待进度条走完,镜像下载完成。

你也可以通过 SSH 终端使用命令行方式拉取,效果相同:

docker pull jellyfin/jellyfin:latest

第二步:创建并配置容器

镜像拉取完成后,点击「创建容器」。这里我们需要进行几项关键配置。

基础设置

为容器起一个容易识别的名字,比如 jellyfin。建议勾选「启用资源限制」,根据你 NAS 的硬件性能,合理分配 CPU 和内存上限,避免 Jellyfin 在转码时占用全部资源导致系统卡顿。

端口映射

Jellyfin 默认使用 8096 端口进行 Web 访问。在「端口映射」中,将本地端口(如 8096)映射到容器的 8096 端口。如果你需要启用 DLNA 功能,还需要映射 1900 端口(UDP)和 7359 端口(UDP)。格式为 本地端口:容器端口,例如 8096:8096

存储空间映射

这是最重要的一步。在「存储空间」设置中,添加以下映射:

  • 将你之前准备好的媒体目录映射到容器的 /media 路径。例如 /vol1/1000/media:/media
  • 新建一个用于存放 Jellyfin 配置和缓存的目录,映射到容器的 /config 路径。例如 /vol1/1000/docker/jellyfin/config:/config

这样做的目的是让 Jellyfin 能够读取你的媒体文件,同时将它的数据库、元数据和缓存保存在 NAS 磁盘上,避免容器重建后配置丢失。

环境变量

在「环境变量」中添加以下两项,用于正确设置时区和用户权限:

  • 变量名:TZ,值:Asia/Shanghai
  • 变量名:PUID,值:0
  • 变量名:PGID,值:0

使用 PUID/PGID 为 0 表示以 root 身份运行,能够避免部分文件夹权限不足的问题。如果你对权限管理有更高要求,也可以替换为你 NAS 中一个具有媒体文件夹读写权限的用户 ID。

完成以上设置后,点击「创建」并启动容器。

第三步:初始化 Jellyfin

在浏览器中输入 http://你的飞牛NAS的IP:8096,进入 Jellyfin 的初始化向导。

  1. 首先设置管理员用户名和密码。请务必牢记,这是你的管理员账户。
  2. 添加媒体库。点击「添加媒体库」,选择内容类型(如电影、剧集、音乐),然后点击「文件夹」旁边的加号,填入 /media/movies/media/tvshows 这样的路径。你可以根据实际目录结构多次添加。
  3. 在「首选元数据语言」中,选择 Chinese 并将国家/地区选为 China,这样刮削到的海报和简介会优先显示中文。
  4. 后续的远程访问和网络设置保持默认即可,除非你有特殊需求。最后点击「完成」,Jellyfin 会自动开始扫描媒体库。

第四步:基础播放与硬件转码设置

初始化完成后,进入 Jellyfin 后台,点击左侧的「控制台」图标。在「播放」设置中,找到「硬件加速」选项。

如果你的飞牛NAS CPU 支持 Intel Quick Sync(大多数 Intel 核显 CPU 都支持)或 NVIDIA 显卡,可以在这里选择对应的加速方案(如 Intel QuickSyncNVENC)。启用硬件转码可以大幅降低 CPU 占用,让 4K 高码率视频播放更加流畅。记得勾选下方的「启用硬件解码」相关选项。

在「用户」设置中,你可以为家人或朋友创建子账户,并为每个账户设置独立的播放权限和家长控制,非常实用。

第五步:进阶技巧与故障排查

  • 修改 Web 端口:如果你不想使用默认的 8096 端口,可以在 Docker 容器的端口映射中修改本地端口,但容器内端口必须保持 8096。
  • 字幕问题:如果播放时字幕无法加载,请检查字幕文件是否与视频文件同名且在同一目录下,或者尝试在 Jellyfin 设置中开启「下载字幕」功能。
  • 媒体文件命名建议:建议采用标准的命名格式,例如 电影名称 (年份)/电影名称 (年份).mkv,这能显著提高元数据刮削的成功率。
  • 更新 Jellyfin:当有新版本发布时,可以在 Docker 镜像页面重新拉取最新镜像,然后停止并删除旧容器,使用相同的配置重新创建新容器即可。得益于 /config 目录的映射,你的所有设置和播放记录都会完整保留。

总结

通过以上几个简单步骤,你已经在飞牛NAS上成功部署了一套功能强大的 Jellyfin 媒体服务器。从电影、剧集到音乐,Jellyfin 都能提供优雅的管理界面和出色的播放体验。配合飞牛NAS的硬件解码能力,你的私人影音中心已经初具规模。后续你还可以探索插件商店、多用户管理、外网访问等更多高级功能,让 Jellyfin 真正成为家庭娱乐的中枢。现在就找一部心仪的电影,享受大屏观影的乐趣吧!

💬 评论区
发表评论

暂无评论,来说两句吧