[240401]Jellyfin中国特供版+Docker镜像，含驱动，免折腾开箱即用

Misaka_9993

前言
由于 Jellyfin 的 GPL 协议和 Intel 的 media-driver (iHD) Linux 驱动（部分开源）在协议上不兼容的缘故，Jellyfin 官方的 Docker 镜像：jellyfin/jellyfin 并不包含 Intel Linux 核显驱动。但是 Intel 的 QuickSync QSV 硬件加速依赖于该驱动，并且 Intel 10 代酷睿（Comet Lake）以及更新的处理器需要该驱动才能正常使用硬件加速。另外 VPP/OpenCL 色调映射也需要该驱动才能正常运作。



考虑到手动安装或编译 Intel 核显驱动对于用户来说并不容易，本文在此提供了一个开箱即用的 Docker 镜像，包含最新的驱动、jellyfin-ffmpeg、补丁、CJK 系统字体等。后续硬件加速的第一手修复也会推送到此镜像中。Docker 配置文件和相关选项可以继续沿用 jellyfin/jellyfin 的相关教程。

个人主要负责 Jellyfin 硬件编解码和滤镜相关功能的开发，范畴之外的功能请求可能不会回应。

---

注意：

使用 Intel 显卡在 Windows 上转码的用户，不要更新 31.0.101.5186/31.0.101.5234 驱动，这个驱动破坏了 OpenCL HDR 色调映射，会导致绿屏。如果不小心更新了，可以回退到上一个版本 31.0.101.5085/31.0.101.5122 ，它是完全正常的。

使用 AMD 显卡在 Windows 上转码的用户，不要更新 Adrenalin 24.1.1 驱动，这个驱动破坏了硬件转码。请回退到23.12.1并等待AMD修复。

---

24/04/01 更新日志：
- 修复 AMD 显卡在 Linux 上色调映射时黑屏的问题
- Jellyfin 10.9就快来了

历史更新日志：

- 修复 PGSSUB/DVDSUB 等图形字幕烧录后的长宽比。
- 为 Rockchip RK3588 平台添加完整的硬件转码（RKMPP/RGA）支持。
- 合并上游版本 10.8.13 变更。
- 将 Jellyfin-FFmpeg 更新至 6.0.1（需要 NVIDIA 驱动程序 520/522 及更高版本）。
- 改进 Windows 上的英特尔 HDR 色调映射性能。
- 修复了 HLS.js 的多个 fMP4 播放问题。
- AV1 硬件和软件编码支持。
- 添加对 Intel Arc GPU 的支持（在 Linux 上需要 6.2+ 内核）。
- 使用 RADV 驱动程序对 AMD VAAPI 进行 Vulkan 过滤支持。
- 支持在 Chrome 104+ 中使用可选标志进行 HEVC 播放。
- VPP 色调映射亮度/对比度增益支持。
- 支持在桌面浏览器上播放 fMP4。
- 杜比视界配置文件 5 和 8 到 SDR 硬件色调映射。
- AMD/Intel/Nvidia 全硬件滤镜支持。
- 实验性 AV1 硬件解码。
- 英特尔低功耗编码。 （减少 4k 转码和色调映射的开销，Gen11 之前的版本仅支持 LP H264）
- 改进了色调映射和字幕烧录性能。


开发者提供的中国特供版镜像


Docker 镜像：
1. 最新版（N卡需要520/522或更新的驱动）
docker pull nyanmisaka/jellyfin:latest

2. 群晖专用版（兼容linux 4.x内核，N卡470老驱动）
docker pull nyanmisaka/jellyfin:latest-legacy


`latest-legacy` 分支使用 Jellyfin-FFmpeg 5.x 和较旧的 Intel Compute-Runtime，这使其与旧内核（例如 Synology NAS 上的 Linux 4.x 内核和 NVIDIA 470 驱动程序）兼容。`latest` 分支使用 Jellyfin-FFmpeg 6.x 和更新的 Intel Compute-Runtime 来支持 AV1 编码和未来的硬件。

Windows 版（安装包+便携版）：
百度云：https://pan.baidu.com/s/1OK6NAtsigq4SUI2DAKDGgw?pwd=q8we

GoogleDrive：https://drive.google.com/drive/f ... GHLNEw299N16YdJVdON

备用：https://hub.docker.com/r/nyanmisaka/jellyfin



国内的docker加速器可能没法同步更新latest标签，请关闭docker加速器，或者直接选择带最新日期的标签进行拉取。否则你可能会拉取到去年的老版本，那是自然不支持infuse插件的。

Jellyfin 10.8 中的硬件加速改进
先前的 Jellyfin 10.7 中启用了 Intel、AMD、NVIDIA 的硬件 HDR 转 SDR 色调映射，但速度还有很大提升空间，且 Intel 核显的完整支持在 Linux。10.8 正式版预计今年发布，敬请期待。

**220602更新：新增支持杜比视界 Profile 5 和 8 转码映射到 SDR。

这次 10.8 测试版更新主要带来的是完全基于显卡的缩放、反交错、色调映射、字幕烧录，免去使用软件滤镜造成的性能损失。另外添加了测试版 AV1 硬件解码支持。

一个很关键的更新是支持了 Windows 10/11 中使用 Intel 核显进行 HDR 色调映射，为了保证理想的速度，请使用诸如 HD/UHD 6xx、UHD 7xx、Xe 系列的显卡，并勾选相应的解码器、硬件编码选项，显卡驱动尽量更新到最新。

NVIDIA 的色调映射切换到 CUDA 内核实现，大幅提升色调映射性能，避免使用 OpenCL 造成的内存拷贝。

AMD 核显支持基于 OpenCL 的滤镜，大幅降低 CPU 占用，此功能仅限 Windows。

修复了 Intel OpenCL 色调映射无法和 PGS 图形字幕同时使用的 BUG，提升了字幕烧录的速度。感谢资深用户 @达文牛 的反馈和发布的一系列教程。


Xe核显Windows下开启HDR色调映射

对于硬件转码设置的一些提示
1. Intel、AMD、NVIDIA 三家的显卡/核显均不支持对 H.264 10bit 硬件加速，请使用 HEVC 10bit 替代。

2. 开启 Low-Power 低电压模式可以提升 Intel 的转码和色调映射性能，此功能在 Windows 下可以直接开启，但在 Linux 下需要手动添加内核参数 i915.enable_guc=2 才能使用。11 代之前的处理器仅支持开启 Low-Power H.264。

3. Linux 下，如果 Intel 核显的 VPP 和 OpenCL 色调映射同时开启，则会优先使用 VPP。VPP 色调映射只支持部分 Intel 核显，目前支持的代号如下：DG1/SG1(独显)、TigerLakeX(1135G7, 1165G7...)、IceLake(1065G7...)、GeminiLake/KabyLakeX(J4005, J5005, i3-7100|8100|9100|10100...) 类比到对应处理器代号的赛扬/奔腾/酷睿 i3/i5/i7/i9 版本。诸如 J3455 的 ApolloLake 处理器不支持 VPP 色调映射。

4. Linux 下，对于 Intel 核显，建议优先使用 QSV 而非 VAAPI，QSV 通常能提供更高的吞吐量。

对于 Intel 转码核显的选择
1. 用于转码 4K HDR HEVC、VP9 10bit 视频的最低配置为 J4005 类似的代号为 GeminiLake 的处理器，即 UHD 600/605。更低或更旧的核显加速效果非常受限，或者只能加速H.264 8bit。

2. 最近新出的 N5105/N6005 系列 Jasper Lake 处理器，产品定位于取代 J4005 同代的处理器，在转码性能上远超后者 Gemini Lake。N5105 具有 24EU 而 N6005 具有 32EU，更多的 EU（Intel 核显运算单元）有助于加快色调映射。所以 N5095 的 16EU 要比前两者慢一些。实测 N6005 双通道内存转码性能接近 HD630 核显。

3. 用于转码 4K HDR HEVC、VP9 10bit 视频的主流配置为 i3-7100/8100/9100/10100 和同代 i5/i7 中的 HD/UHD630 核显，此类核显可以胜任绝大部分 4K HDR HEVC VP9 10bit 转码，包括 Linux 和 Windows 下的色调映射。



4. 用于转码 4K HDR HEVC、AV1、VP9 10bit 视频的发烧级配置为 Xe 核显或 UHD770 核显。与上面提到的UHD6xx 具有第 9 代图形架构不同的是，此新核显为 Intel 的第 12 代图形架构，并且辅以 2 个编解码引擎。在转码效能上有很高的提升，几乎是翻倍的速度。选购前可以搜索“处理器名称 ark”来查看核显详细规格，如上图所示“多种格式编解码器引擎”数量为 2 。


11代桌面端的UHD750/730核显，雪花故障请更新主板BIOS解决。
移动端1135G7/1165G7之类的不受影响。
https://tieba.baidu.com/p/7757843300
https://zhuanlan.zhihu.com/p/465395656
https://community.intel.com/t5/G ... 5-video/m-p/1326081

结语


感谢大家对 Jellyfin 开源媒体系统的持续关注和使用！


过去的两年里我对 Jellyfin 的硬件加速进行了很多改进和测试，并添加了基于 CUDA 和 OpenCL 的 HDR 色调映射功能，以保证在主流硬件上的运行和不输 Emby 和 Plex 的硬件转码性能。用爱发电不易，购置硬件测试更不易，如果觉得我的作品对你有帮助，欢迎到我的Github主页赞助我。

Misaka_9993

lzyshiki 发表于 2021-12-20 23:27
我现在是WINSERVER 10.7.6 直接覆盖文件就可以了么 自从装好以后从来就没更新过 ...

目前这个不是安装包。windows版需要给jellyfin-server里的jellyfin.exe加一个自启动。以后再搞安装包。

22.3.19 更新：已经提供Windows版的exe安装包，也有便携版。

Misaka_9993

基胖 发表于 2022-2-7 22:05
麻烦大佬，为什么播放这种格式的，视频会一顿一顿的，转码播放就可以，但是自动会识别成直接播放 ...

Edge浏览器和HEVC插件有bug，需要自行降级。
https://cloud.189.cn/web/share?code=YF3MnefANzYn（访问码：qs80）

HEVC抖动的问题已经在Edge 99和最新的HEVC插件中解决，请自行检查更新。

Misaka_9993

23/01/18更新：

- 合并上游代码，更新 Jellyfin 10.8.8

- 正式支持 Intel Arc 系列独显（Linux内核需要6.2.0+或drm-tip）

Misaka_9993

前排提示，如果感觉 HDR 色调映射亮度太暗，可以把算法换成 BT.2390。

建议开启 Intel Low-Power 编码器，提升性能。

给出一些 Windows 下的数据仅供参考：

7代4核酷睿 HD 630
转码+映射 4K HDR->1080p SDR 速度大概在90~120fps
转码+映射 4K HDR->4k SDR 速度大概在40~70fps

如果有烧录字幕，速度会略有降低。

后续 docker 镜像更新请认准：

Misaka_9993

Docker 镜像已经提供：
docker pull nyanmisaka/jellyfin:latest

spacer

请问怎么解决 jellyfin 外挂 srt 字幕不同步的问题（就是如果从头播放是同步的，一旦跳转中间某个段落，就再也没法同步）
如果要问我为什么不用内嵌字幕。。内嵌字幕都要转码烧录，在 J4125，linux 下播放极慢，关掉字幕或者用 srt 转码秒开

Misaka_9993

spacer 发表于 2021-12-3 13:28
请问怎么解决 jellyfin 外挂 srt 字幕不同步的问题（就是如果从头播放是同步的，一旦跳转中间某个段落，就 ...

浏览器渲染字幕不同步确实偶尔存在。你可以试试这版docker了，烧录会快非常多。

DASINIX

群辉docker怎么更新呢- -试了几个命令好像都不行

Misaka_9993

DASINIX 发表于 2021-12-3 13:33
群辉docker怎么更新呢- -试了几个命令好像都不行

备份一下Docker的设置，然后把其他教程里的仓库换成从我这个仓库拉取
docker pull nyanmisaka/jellyfin:latest

侠客126

看了一下，pve直装的jellyfin还是10.7.7，看来10.8还没推
不过10.7以后转码啥的都流畅多了

Misaka_9993

侠客126 发表于 2021-12-3 14:16
看了一下，pve直装的jellyfin还是10.7.7，看来10.8还没推
不过10.7以后转码啥的都流畅多了 ...

10.7我觉得还不够哈哈，烧录字幕和HDR色调映射的速度都和我这个镜像差挺大的

lizhenbj

再用群晖套件版本的jellyfin，现在版本10.7.
可以直接再用docker安装10.8么？除了端口重复需要修改外，这两个是否可以共存，还是只能先把原来套件版删除掉，在重新下载安装这个？

treedom

等等正式版吧，唯一感觉遗憾就是psg字幕烧录。不知道解决了不

Misaka_9993

lizhenbj 发表于 2021-12-3 21:02
再用群晖套件版本的jellyfin，现在版本10.7.
可以直接再用docker安装10.8么？除了端口重复需要修改外，这两 ...

需要停用另一个老版本jellyfin，因为端口会冲突。

机狂一个

感谢，买完plex，再来个jellyfin，cpu i5 1135G7 Xe核显，ubuntu 20.04 docker下两种解码测试成果奉上，
vaapi
qsv

从测试结果来看建议用qsv，vaapi转码不但速度慢，而且感觉颜色丢失的比较厉害

Misaka_9993

treedom 发表于 2021-12-3 21:24
等等正式版吧，唯一感觉遗憾就是psg字幕烧录。不知道解决了不

这个版本就是专门解决PGS烧录慢的。

Misaka_9993

机狂一个 发表于 2021-12-3 21:26
感谢，买完plex，再来个jellyfin，cpu i5 1135G7 Xe核显，ubuntu 20.04 docker下两种解码测试成果奉上，
va ...

你这是4k转码成4k，还开了色调映射。有60fps不错了。色彩不鲜艳就关掉VPP，换成算法BT.2390。

treedom

Misaka_9993 发表于 2021-12-3 21:26
这个版本就是专门解决PGS烧录慢的。

谢谢发布。我试试看。

lizhenbj

Misaka_9993 发表于 2021-12-3 21:25
需要停用另一个老版本jellyfin，因为端口会冲突。

感谢，先停用套件版那个，docker安装新版测试一下。

treedom

Misaka_9993 发表于 2021-12-3 21:26
这个版本就是专门解决PGS烧录慢的。

安装步骤还是：（1）安装/更新 intel 驱动
（2）安装/更新 ffmpeg
（3）安装字库补丁
看你介绍第三步就略过可以咯。
只要1.2就可以了是吧

Misaka_9993

treedom 发表于 2021-12-3 21:33
安装步骤还是：（1）安装/更新 intel 驱动
（2）安装/更新 ffmpeg
（3）安装字库补丁

（1）我的docker包含intel驱动、fonts-noto-cjk字体包
（2）最新 ffmpeg 在下载压缩包和镜像里自带，只需要确保设置里的指向路径正确

Windows的话可以更新下驱动

treedom

Misaka_9993 发表于 2021-12-3 21:41
（1）我的docker包含intel驱动、fonts-noto-cjk字体包
（2）最新 ffmpeg 在下载压缩包和镜像里自带，只需 ...

抱歉再次提问，我是docker下载，按你意思下载来配置路径直接可用？都不用下载更新?

Misaka_9993

treedom 发表于 2021-12-3 21:44
抱歉再次提问，我是docker下载，按你意思下载来配置路径直接可用？都不用下载更新? ...

是的。这个docker是整合包。不用自己折腾。
如果你用浏览器显示字幕，还需要另外自己配置备用字体路径，我就不再赘述了。

机狂一个

Misaka_9993 发表于 2021-12-3 21:28
你这是4k转码成4k，还开了色调映射。有60fps不错了。色彩不鲜艳就关掉VPP，换成算法BT.2390。 ...

vappi不能打啊，关闭vpp映射开启hdr，测试结果

Misaka_9993

机狂一个 发表于 2021-12-3 21:50
vappi不能打啊，关闭vpp映射开启hdr，测试结果

我的意思是

机狂一个

Misaka_9993 发表于 2021-12-3 21:53
我的意思是

我的意思qsv比vappi强上不少，这下舒服了

treedom

解决转码烧录问题。更正

Misaka_9993

treedom 发表于 2021-12-3 22:33
解决转码烧录问题。更正

问一下这是什么CPU？

treedom

Misaka_9993 发表于 2021-12-3 23:11
问一下这是什么CPU？

qnap451d，j4025

Misaka_9993

treedom 发表于 2021-12-3 23:19
qnap451d，j4025

看起来HDR色调映射也是开启的，加上同时烧录字幕，能有46fps，对于这么个低电压处理器已经很不错了

treedom

Misaka_9993 发表于 2021-12-3 23:11
问一下这是什么CPU？

请问后续会更新正式版嘛？如果更新正式版是不是拖一下库就可以了，我是docker，不需要更改啥设置。感谢版本更新的付出。

treedom

Misaka_9993 发表于 2021-12-3 23:38
看起来HDR色调映射也是开启的，加上同时烧录字幕，能有46fps，对于这么个低电压处理器已经很不错了 ...

vpp映射打开的，色彩我个人感觉还可以吧，而且psg字幕烧录也正常，是4k转1080-10mbps，体验效果已经很棒了。再次感谢付出，我们体验感不错。