在ESXi 7.0u3e里直通N5105的核显给虚拟机Debian 11/Ubuntu 22.04(更新到5.18内核)，再套用Docker镜像nyanmisaka/jellyfin (10.8.1) 启用硬件转码。 测试片源America.Wild.National.Parks.Adventure.2016.BluRay.2160p.x265.10bit.HDR.2Audio.mUHD-FRDS.mkv，关硬件转码1080p 10Mbits CPU 100%+卡顿，开硬件转码不报错CPU 50%左右流畅。查看log确认是QSV硬件转码。 以下所有教程都来自网络并注明了引用出处，一并向各位原创者表示感谢。

这里 N5105/N6005 群晖 核显解码 配置参考 是一个用N5105直接物理安装黑群晖DS918+ 6.23的成功实现硬件转码的案例。我试着把核显直通给黑群晖DS918+6.23虚拟机，按照帖子里的要点可以打上核显补丁，在黑群系统里看到核显，但是jellyfin调用不成功，开启硬件转码后客户端提示“播放错误该客户端与媒体不兼容，服务器未发送兼容的媒体格式”，并一直循环报错。用软解CPU占用率自然是100%而且卡顿无比，毕竟N5015的主业是软路由，总不能因为看片影响了上网，所以这种方式没有实用价值。

那么用EXSi做宿主机是否一定不能直通核显到虚拟机实现硬件转码呢？毕竟以N5015的性能，只干软路由这一项工作明显大材小用了，尤其是Intel核显UHD一直闲置，不能物尽其用终觉遗憾。

我想到，群晖是基于Linux发行版Debian二次开发的Linux系统，既然核显能够直通到黑群里，应该也可以直通到其它Linux里，至少应该能直通到Debian / Ubuntu里，而群晖本身是没有加载GUI图形界面的，那么只要Debian / Ubuntu也不启动图形界面，理论上应该可行。于是我开始了摸索和尝试，在几篇教程的指引下，终于成功实现了这个目的。

有人说这是BUG，博主认为这个应该是ESXi的管理机制：每次ESXi重启后，宿主会直接忽视核显直通然后获得核显的使用权，应该是为了防止在直通核显以后又误将管理口网卡直通出去造成ESXI无法进入管理界面的尴尬。这个可以关掉的：

1、在电脑浏览器打开ESXi，在菜单中开启SSH；

2、在电脑上打开MobaXterm或者Putty等软件，用root账号登录到ESXi的SSH下；

3、输入一条命令（须注意英文的大小写和空格），回车：

4、重启ESXi生效。 N5105 BIOS 版本 ： V5.19 N5105 核心显卡的 Device ID ： 0x4e61

注意：不要选择任何GUI图形化桌面

说明： 以下所有Linux命令都是用root用户执行。如果用普通用户执行，可能需要加上sudo，请自行测试。 因为后面我们要禁用虚拟机默认的虚拟显卡，将会导致虚拟机的控制台不可操作，只能远程SSH登录后操作，所以在操作核显之前，我们要先配置好Debian 11 / Ubuntu 22 的静态IP和SSH登录。 先在线升级一下各组件，下载速度慢的请自行设置一下国内的镜像源:

安装一下后面要用到的工具

(如果安装时已经设定为静态IP的可以跳过这一步)

先按 i 进入编辑模式，然后修改iface ensxxx inet dhcp 一行里的dhcp为static，ensxxx要和你的实际网卡名字保持一致，IP\子网掩码\网关\DNS这四行根据实际情况添加：

编辑完成后 先按ESC，退出编辑模式，再按英文冒号键:然后输入wq最后回车就可以保存并退出。

重启网络让新IP生效：

Ubuntu 比 Debian要麻烦一些，Ubuntu从17.10开始，已放弃在/etc/network/interfaces里固定IP的配置，即使配置也不会生效，而是改成netplan方式 ，配置写在/etc/netplan/00-installer-config.yaml或者类似名称的yaml文件里：

先按 i 进入编辑模式，然后修改为下面这个样子，其中ensxxx要和你的实际网卡名字保持一致，IP\网关\DNS根据实际情况添加（注意每一层前边的缩进，至少比上一层多两个空格）：

编辑完成后先按ESC，退出编辑模式，再按英文冒号键:然后输入wq最后回车就可以保存并退出。

重启网络让新IP生效：

如果安装时没安装SSH服务，请先安装:

检查状态:

确认SSH服务是enabled状态，可以开机自启动： 修改sshd_config文件允许root用户远程登录： 这一步操作会减弱Debian / Ubuntu主机的安全性，不过家用一般也不用太在意，特别在意的可以设置为SSH公钥/私钥免密登录，具体方法网上有教程，也可以看这里SSH无密码登录及WinSCP和PuTTY设置。

先按 i 进入编辑模式，然后找到以下几行并去掉前面的注释标记#号，并修改后面的设定值:

编辑完成后 先按ESC，退出编辑模式，再按英文冒号键:然后输入wq最后回车就可以保存并退出。

Ubuntu还需要手动为root用户设置密码：

重启SSH服务:

打开MobaXterm或者Putty等软件，用root账号和密码尝试连接运行在Debian / Ubuntu 的IP 22端口上的SSH服务，确定可以正常登录和输入命令。

下载已编译的5.18内核二进制安装包，并安装:

查看已安装的内核:

返回：

重启：

重启后查看新内核生效了没有:

正常情况应该返回:

Ubuntu 22.04安装好以后是5.15内核，我们把它升级到5.18内核：

下载ubuntu-mainline-kernel脚本：

将脚本放在可执行路径中：

检查当前可以下载安装的内核版本：

返回：

下载安装指定版本内核v5.18.19：

返回：

查看当前已通过该脚本安装的内核版本：

返回：

重启：

重启后查看新内核生效了没有:

返回:

代表新内核成功启用。

现在关闭Debian 11 / Ubuntu 22 虚拟机，在ESXi 7里将核显PCI设备添加到虚拟机的硬件里：

然后在虚拟机选项-高级-配置参数-编辑配置里，将svga.present由TRUE改为FALSE，保存并启动虚拟机。 开机后虚拟机控制台将一直呈现灰色而不可用，稍等片刻可以尝试SSH连接设置好的静态IP的22端口。如果不出意外，应该可以用root用户直接远程登录继续执行下面的操作。

验证核显是否已经加载：

返回:

说明核显已经正常识别加载。

（以下内容主要来自 N5105 PVE docker-compose 安装Jellyfin 并实现 硬解码 、 N5015使用心得 、软路由N5105硬解方案归纳、 司波图 / 通用PVE AIO安装教程 和 N5105 jasper lake 开启硬件转码方法） 。

然后上传到/lib/firmware/i915，如果i915目录不存在就先创建它：

也可以直接在Debian里下载：

感谢恩山论坛玩家网友lifansimj指出使用wget命令直接拉取的固件文件大小可能有误，建议用电脑浏览器下载后上传到Debian。 从这里下载： 或者： 完成后注意核对文件大小和权限：

返回：

在WinSCP里看是这样的： 补充：（可选，非必须）如果想安装完整版的最新固件，可以从这里下载（压缩包文件大小达近400MB，解压后更大，浪费硬盘空间，非必要情况不建议下载)，以下命令供参考：

相比之下，Ubuntu 22.04就省事多了，已安装的固件包比较全，已经包含最新的i915固件，可以列一下看看：

返回：

与在Debain部分手动下载的三个文件大小是一致的，所以建议使用Ubuntu 22.04。

编辑grub配置文件，强制开启 HuC 和 GuC：

先按 i 进入编辑模式，然后找到并修改 GRUB_CMDLINE_LINUX_DEFAULT="quiet" 为：

编辑完成后 先按ESC，退出编辑模式，再按英文冒号键:然后输入wq最后回车就可以保存并退出。

然后更新grub菜单:

或者:

重启:

补充说明：guc引导项不同的参数不同的作用，具体如下：

经过我的测试，如果/etc/default/grub这里设置i915.enable_guc=2，GuC submission会是disabled，不确定是否会影响硬件转码，就还是设置为3吧。 至此，核显设置就安装完成了。

安装intel-gpu-tools，可以用intel_gpu_top命令查看gpu的运行状态

重启后，验证低功耗编码HuC和GuC是否开启:

返回:

因为之前并没有在虚拟机里手动导入核显的VBios（这是另外一个复杂的工程），所以有一堆的和VBT有关的*ERROR*，这可能就是虚拟机不能开启图形界面的原因，会导致虚拟机系统进入图形界面时直接卡死。还好我们只是把核显用来解码和编码，最关心的HuC和GuC都成功开启了:

特别提示：如果上面的日志里有错误提示加载某个固件.bin不成功，请仔细核对一下文件路径、文件名、文件大小和文件权限，按照日志里的提示到相应的地址下载对应的固件文件，上传到/lib/firmware/i915并设置好文件权限即可。

在Debian / Ubuntu 的SSH中输入命令:

下载速度慢的话可以试试指定国内的源，例如阿里云：

检查：

如果能看到以下说明成功：

目前docker-compose的最新版本是v2.6.1，如果有更新的版本，请相应替换：

将可执行权限应用于二进制文件：

创建软链：

执行完成后输入：

如果能看到版本号的输出，即表示安装成功，例如：

首先需要规划jellyfin安装在什么位置 例如/opt/apps/jellyfin

请注意，如果将来索引和转码的视频数量很多，jellyfin的config和cache文件夹可能膨胀到大几十GB，请确保安装挂载点有足够的磁盘空间可以容纳。

创建jellyfin安装挂载点/opt/apps/jellyfin，并在该处新建三个挂载文件夹config 、cache 和media：

创建完成后开始编写docker-compose.yml文件：

先按 i 进入编辑模式，然后复制以下内容：

几点说明：

端口说明：

编辑完成后 先按ESC，退出编辑模式，再按英文冒号键:然后输入wq最后回车就可以保存并退出。 以上就做好了启动Jellyfin的所有准备。

输入命令启动Docker容器：

就会开始拉取镜像，并启动jellyfin。 等执行完毕后再次输入：

就可以看到jellyfin正在运行中：

耐心等待容器初始化完成。

进入容器内部看一下核显是否成功挂载：

上面命令中的jellyfin就是docker-compose.yml里设定好的容器名container_name。

在容器内部查看核显是否挂载：

返回：

和在Debian / Ubuntu 宿主机里一样，说明容器成功挂载核显。

输入：

退出容器。

这时在浏览器地址栏输入http://Debian or Ubuntu 的ip地址:8096就可以进入jellyfin后台，例如http://192.168.1.18:8096

我的视频文件全在另一部群晖里，已开启了NFS共享服务NFS版本v4.1，权限为可读写（具体设置方法请在网上搜索群晖NFS设置教程）。以下的设置仅供参考： 为Debian安装NFS客户端：

假设远程群晖主机（192.168.1.19）NFS共享出来了/volume2/video这个文件夹，先尝试手动挂载它：

检查一下挂载是否成功：

成功后可以修改/etc/fstab实现开机自动挂载（这可能会在后面引起一点小问题，最后有解决办法）：

先按 i 进入编辑模式，添加一行：

编辑完成后 先按ESC，退出编辑模式，再按英文冒号键:然后输入wq最后回车就可以保存并退出。

媒体文件确定挂载成功后，需要重启容器一次让jellyfin读取它：

或者先停止再启动

设置媒体文件夹时要注意：

媒体文件夹在容器内的路径是 /media，jellyfin设置页面添加媒体文件夹的路径应该用容器内的路径如/media/movie、/media/tv，因为容器内的/media被映射到我们上面设置好的宿主机/opt/apps/jellyfin/media，容器内/media/movie对应的就是宿主机/opt/apps/jellyfin/media/movie，以此类推。

按下面的图片内容来设置硬件转码，设置完保存即可：

测试片源America.Wild.National.Parks.Adventure.2016.BluRay.2160p.x265.10bit.HDR.2Audio.mUHD-FRDS.mkv，带字幕：

纯CPU转码，转码为1080p 10Mbps H264视频，烧录字幕，转码帧率只有20fps：

开启硬件转码后，还是转码为1080p 10Mbps H264视频，烧录字幕，转码帧率53fps：

执行：

查看核显解码时的运行状态：

从这里也可以看出核显在工作了。

还是转码为1080p 10Mbps H264视频，转码帧率44fps：

后续使用中发现虚拟机重启后，因为NFS挂载需要一点时间，但是Docker已经启动，会发生jellyfin无法识别媒体文件夹内容的情况，表现是播放文件弹出“播放错误该客户端与媒体不兼容，服务器未发送兼容的媒体格式”提示，和硬解没有成功开启的提示是一样的，但查看核显状态正常。 执行：

后错误消失。

解决思路就是延迟启动Docker服务，等待NFS挂载成功后再启动：

Debian 11 和 Ubuntu 22 默认不带 /etc/rc.local 文件，而rc.local服务却还是自带的，需要手工添加一个 /etc/rc.local文件：（以下为一整条命令，请一起复制到ssh命令行运行）