一步步打造群晖 Docker 环境中的 Jellyfin 媒体服务器，从共享文件夹设置、Docker 映像选择、硬件解码选项开启，到转码测试与性能观察。
声明
本文适用于你合法拥有或授权操作的 NAS 环境。硬件解码需基于支持的 CPU/iGPU 型号（教程适用于 Intel 4-14代）或已实现直通的虚拟群晖。请提前确认你的设备与驱动支持情况。测试机型为SA6400。
适用机型与硬件解码简介
本教程适用于安装在群晖或虚拟群晖环境中的 Jellyfin，且建议设备使用 Intel 4-14 代 CPU 或设备已将 iGPU 直通至虚拟机。
硬件解码优势体现在转码高分辨率影片（如 4K）时，使用 iGPU 能显著降低 CPU 占用、提升流畅性。教程实测中，在可开启硬解的环境下帧率可达 57fps 以上。
使用 Docker 部署可简化环境隔离、便于迁移与更新管理。
创建共享文件夹准备媒体库
在群晖 DSM 中打开 File Station – docker 文件夹 – 新建文件夹 jellyfin – 在文件夹 jellyfin 下新建两个文件夹：config、 cache
在群晖 DSM 中打开 File Station – 新建一个共享文件夹（例如 “media”）（如你已有设置好的存放资源的文件夹，此处可跳过）。
右击该共享文件夹 – 属性 – 权限 – 为
Everyone设置 读／写 权限。
此共享文件夹将在 Docker 映像中作为
/media挂载，影片文件上传至此以供 Jellyfin 使用。
下载 Jellyfin 映像与容器配置
- 打开 Container Manager – 镜像仓库 – 搜索 jellyfin – 选择 nyanmisaka/jellyfin – 右键选择下载此映像 – 默认下载即可，会自动跳转到映像里面下载，下载失败多试几次。
目前在官方的 Docker 仓库里，有三个主流的Jellyfin的容器，分别是 jellyfin/jellyfin、linuxserver/jellyfin和nyanmisaka/jellyfin。
jellyfin/jellyfin 为官方镜像，貌似仅限 x86/amd64 平台；
linuxserver/jellyfin 镜像，根据说明，可以使用在 x86/amd64 平台上，也可以使用在 ARM 的平台上;
nyanmisaka/jellyfin 的镜像，也是只能用在x86/amd64平台上，但该镜像集成了显卡驱动和字体，可直接使用，无需配置，可以直接跳到 Jellyfin 系统设置章节；
- 在映像里面 nyanmisaka/jellyfin右键 – 运行 – 自取名称 – 勾选自动重启 – 下一步
- 端口设置 – 本地端口跟容器端口保持一致或者自己选择一个即可（前提是该端口没有被占用，且端口尽量应该选大一点的，避免被扫描到）ps: 设置常用的端口为 8096
- 存储空间设置 – 添加文件夹 – 左侧选中创建的cache文件夹，如
/volume1/docker/jellyfin/cache，右端填入/cache - 存储空间设置 – 添加文件夹 – 左侧选中创建的cache文件夹，如
/volume1/docker/jellyfin/config，右端填入/config - 存储空间设置 – 添加文件夹 – 左侧选中创建的cache文件夹，如
/volume1/docker/jellyfin/cache，右端填入/cache - 存储空间设置 – 添加文件夹 – 左侧选中创建的资源文件夹，如
/volume1/影视/电影，右端填入/media1；若有多个，再添加文件夹，右端改为/media2，以此类推 - 勾选 使用高权限执行容器（以确保硬件解码权限、设备访问权限）
- 网络选择 bridge或者host 都可
- 启动容器，并使用浏览器访问
http://你的NASIP:8096完成初次设置。
安装向导
使用浏览器访问 http://你的NASIP:8096，以创建电影库为例：
这一步若出现的是选择服务器界面，请清理浏览器缓存刷新页面
完成后如首页部分条目暂时无封面/简介，属正常现象；后续进行“刮削优化”步骤。
- 界面语言：汉语（简体字）
- 创建 管理员账户、密码
- 添加媒体库：类型选“电影”（对于电视剧和动漫，类型选择“混合电影和电视节目”），自己取个名即可，
- 文件夹：选择你要读取资源的对应文件夹；找不到手动到File station里面找到该文件夹右键-属性，即可看到目录，复制并粘贴即可，
- 首选下载语言：Chinese，
- 国家/地区：People’s Republic of China，
- 勾选优先使用内置的标题而不是文件名，
- 元数据储存方式勾选 NFO，
- 勾选将媒体图像保存到媒体所在文件夹，
- 点击确定。
有其它媒体库请重复该操作。
点击下一个-语言选择中文-国家/地区选择People’s Republic of China-点击下一个-下一个-完成-重新登录一下即可
元数据刮削优化（TMDB 可达）
在部分网络环境下，TMDB 域名解析与连接可能不稳定。可按下列思路临时改良可达性（提示：hosts 绑定 IP 可能随时间失效，请仅作为排障手段）：
访问站长工具，进行 Ping检测：https://tool.chinaz.com/ 输入api.themoviedb.org
找颜色是绿的（延迟低的），将若干可通的 IP 记录为“IP + 空格 + 域名”的格式（每一行一条记录），例如：
74.231.41.102 api.themoviedb.org
102.10.29.16 api.themoviedb.org
建议复制很多个，这样能使用的时间越久
同样的操作，在站长工具输入image.tmdb.org
找颜色是绿的（延迟低的），将若干可通的 IP 记录为“IP + 空格 + 域名”的格式，例如：
74.231.41.102 image.tmdb.org
102.10.29.16 image.tmdb.org
群晖开启 SSH 并编辑 hosts
群晖-控制面板 – 终端机与 SNMP – 勾选 启用 SSH功能（默认端口 22）-点击应用；
对于windows系统，直接 win + r 输入 ssh 你的群晖的账户名@你的群晖的ipv4地址，输入密码即可在终端连接到群晖
对于ubantu系统，直接在终端输入 ssh 你的群晖的账户名@你的群晖的ipv4地址，输入密码即可在终端连接到群晖
输入：sudo -i ，输入密码获取 root 权限，输入：vi /etc/hosts，编辑 hosts
在文件末尾追加你收集的 IP 记录，保存退出(英文输入):wq
对于刮削失败的资源，右键-刮削元数据-输入资源的名字-选择正确的版本即可
启用硬件解码设置
-
登录 Jellyfin 后：控制台 – 播放 – 编解码 – 下拉选择“Video Acceleartion API(VAAP)”或者“Intel QuickSync(QSV)”，不是太老的CPU/显卡，建议选QSV；（具体选项因映像及硬件而异）。QSV设备一栏直接留空。
-
启用硬件解码：根据显卡支持的解码进行选择，Intel J3455及以上的CPU，即UHD500及以上的显卡可以全选；对于ubantu系统，AV1不勾选（10代及10代以下也不勾选）
-
不勾选首选系统原生DXVA或VA-API硬件解码器
-
硬件编码选项：启用硬件编码、启用低电压模式的Intel H.264硬件编码器、启用低电压模式的Intel HEVC硬件编码器 三个全部勾选；对于ubantu系统，启用低电压模式的Intel H.264硬件编码器（10代及10代以下也不勾选）
-
编码格式选项：允许以HEVC格式编码、允许以AV1格式进行编码 全部勾选 ；对于ubantu系统，允许以AV1格式进行编码不勾选（10代及10代以下也不勾选）
-
勾选 启用色调映射
-
上传测试片（建议 4K 、HDR类型的检测片）至 资源 路径 → 在媒体库中加入 → 启动播放并观察转码显示情况。（观察是否cpu的利用率比较低）
-
若开启失败，请核查以下：
-
容器是否具备访问
/dev/dri的权限（iGPU 设备）； -
群晖 BIOS/VMware 是否开启 iGPU；
-
Jellyfin 映像是否支持你的 iGPU 型号；
-
驱动是否正确加载（可 SSH 检查
ls /dev/dri）
-
一些tips
有些资源的默认音频可能是EAC3，不是AAC，可能会无法播放。这时候可以下一个软件：格式工厂，直接将资源的音频进行转换即可（视频处选copy，音频选择AAC即可，这样不需要消耗太大的cpu资源，速度也很快~）
