Docker 玩法

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

2026-08-05 2 views 0 收藏 admin

在飞牛NAS上部署Jellyfin，等于把散落在各处的电影、剧集、照片和音乐统一收纳进一个优雅的媒体库。Jellyfin完全开源免费，没有授权费，也不需要外部服务器中转数据，所有转码和播放都在你的NAS本地完成。这篇教程会带你从零开始，用Docker方式把Jellyfin跑起来，并完成基础配置。

准备工作：确认飞牛NAS环境

开始之前，请确保你的飞牛NAS系统版本在0.8.0以上，且已经启用了Docker服务。你可以在飞牛桌面的“应用中心”里找到Docker并安装。另外，建议给Jellyfin预留至少4GB内存和20GB存储空间，如果后续要转码4K视频，内存最好加到8GB。

第一步：创建媒体目录结构

SSH登录到你的飞牛NAS，或者直接在飞牛桌面的“文件管理”里操作。我们建议建立清晰的目录，方便后续挂载：

# 在存储池1的docker目录下创建jellyfin专用文件夹
mkdir -p /vol1/1000/docker/jellyfin/config
mkdir -p /vol1/1000/docker/jellyfin/cache
mkdir -p /vol1/1000/media/movies
mkdir -p /vol1/1000/media/tvshows
mkdir -p /vol1/1000/media/music

这里/vol1/1000是飞牛NAS默认的存储路径，如果你把存储池建在别的位置，请对应修改。config目录存放Jellyfin的数据库和设置，cache目录缓存转码临时文件，media目录则按类型分好子文件夹。

第二步：用Docker命令部署Jellyfin容器

打开飞牛NAS的终端（SSH），执行以下命令拉取并运行Jellyfin容器：

docker run -d \
  --name jellyfin \
  --restart=always \
  -p 8096:8096 \
  -p 8920:8920 \
  -e TZ="Asia/Shanghai" \
  -e PUID=1000 \
  -e PGID=1000 \
  -v /vol1/1000/docker/jellyfin/config:/config \
  -v /vol1/1000/docker/jellyfin/cache:/cache \
  -v /vol1/1000/media:/media \
  --device=/dev/dri:/dev/dri \
  jellyfin/jellyfin:latest

参数说明： -p 8096是HTTP访问端口，8920是HTTPS端口，你可以在飞牛NAS的防火墙里放行这两个端口。 PUID和PGID设置为1000，对应飞牛默认用户，避免权限问题。 /dev/dri是Intel核显设备映射，如果你的CPU是J4125、N5105这类带核显的型号，这个参数能启用硬件转码。如果CPU不支持，去掉--device那行即可。

等待容器启动后，在浏览器输入 http://你的飞牛IP:8096 ，应该能看到Jellyfin的初始化向导。

第三步：通过初始化向导设置管理员账号

首次访问会进入设置向导，按以下步骤操作：

  1. 选择显示语言为“简体中文”。
  2. 创建管理员用户名和密码，建议使用强密码。
  3. 添加媒体库时先跳过，后面手动配置更灵活。
  4. 设置首选元数据语言为“中文”。
  5. 远程访问选项保持默认，最后点击完成。

完成后用刚创建的管理员账号登录。

第四步：添加媒体库并配置刮削器

登录后进入控制台，点击“媒体库” -> “添加媒体库”，以电影库为例：

内容类型选择“电影”，显示名称填“电影”，然后点击文件夹旁的加号，选择/media/movies。这里注意，由于我们之前把整个/media挂载进了容器，所以路径直接以/media开头即可。

往下滚动，在“元数据下载器”里勾选“The Movie Database”和“The Open Movie Database”，并在“图片获取器”里同样勾选TMDb。如果网络访问TMDb较慢，可以在“高级”里把“下载语言”设为“zh-CN”，并勾选“首选图像语言为中文”。

保存后，Jellyfin会自动扫描文件夹并抓取海报、简介和演员信息。如果某些电影刮削不到，可以手动修改文件名，推荐格式为“电影名 (年份).mkv”，例如“盗梦空间 (2010).mkv”。

第五步：启用硬件转码（Intel核显）

如果你的NAS支持Intel Quick Sync，这一步能大幅降低转码时的CPU占用。进入控制台 -> “播放” -> “转码”，在“硬件加速”下拉框选择“Intel QuickSync (QSV)”，然后勾选“启用硬件解码”和“启用硬件编码”。

如果下拉框是灰色的，说明容器没有映射到核显设备。请检查docker run命令中是否包含了--device=/dev/dri:/dev/dri。对于Jellyfin 10.8及以上版本，还需要在容器内安装Intel驱动，不过飞牛NAS的Docker镜像通常已经预装，直接启用即可。

第六步：设置远程访问（可选）

如果你希望在外网访问Jellyfin，有两种方式：

方式一：在飞牛NAS的“网络设置”里配置端口转发，将外网端口映射到内网的8096端口。注意Jellyfin支持HTTPS，你可以配置Let‘s Encrypt证书，在控制台 -> “网络”里填写域名并开启HTTPS。

方式二：使用Tailscale或ZeroTier组虚拟局域网，这样无需公网IP也能安全访问。在飞牛NAS的Docker里再部署一个Tailscale容器，与Jellyfin容器同网络，手机和电脑也装上Tailscale客户端，即可通过虚拟IP访问Jellyfin。

第七步：客户端播放与常见问题

Jellyfin支持全平台客户端，在飞牛NAS上你可以直接用浏览器播放，也可以安装手机端的“Jellyfin”App。电视端推荐使用“Jellyfin for Android TV”或“Jellyfin for Kodi”插件。

如果播放时遇到卡顿或无法播放，先检查以下两点：

第一，在控制台 -> “播放” -> “回放”里，把“流式传输比特率”的默认值从自动改为40Mbps，避免网络带宽判断错误。

第二，如果字幕无法显示，请在“字幕”设置里勾选“启用字幕提取”，并把“烧录字幕”设为“仅当需要时”。

总结

通过以上步骤，你已经成功在飞牛NAS上部署了Jellyfin媒体服务器，并完成了基础调优。整个过程的核心在于合理规划目录结构、正确映射硬件设备，以及耐心配置刮削器。Jellyfin的生态非常丰富，后续你还可以安装插件（如中文搜索、豆瓣评分）、设置定时扫描，甚至配合Tdarr做自动转码。现在就去把你的电影文件夹丢进/media/movies，享受属于自己的流媒体服务吧。

💬 评论区
发表评论

暂无评论，来说两句吧