摘要

在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折腾经历

我的N5105软路由是2022年4月底入手的，我也不清楚算是第几版，主板型号是 MW-JSL2.5G-4L，两个内存插槽，两个USB3.0，1个Nvme接口，1个mini-PCIe接口，1组SATA电源+数据接口，另外主板上还预留有两个USB2.0接口的扩展插座和一个12V风扇插座（实测不支持PMW调速）。

到手时BIOS就是传说中可以直通核显的版本v5.19：

但是当我在ESXi 7.0中试着直通核显给Windows或者Ubuntu虚拟机却一直没有成功，表现是直通核显后虚拟机开机出现图形界面即死机。

这个帖子 软路由N5105硬解方案归纳 归纳了三种N5105核显成功实现硬件转码的情况，宿主机分别是PVE 7.2、Unraid 6.12和Windows server 2019，本质上核显都是在宿主机上实现驱动或者用容器调用宿主机的核显，并没有把核显真正直通给虚拟机。

这里 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也不启动图形界面，理论上应该可行。于是我开始了摸索和尝试，在几篇教程的指引下，终于成功实现了这个目的。

一、ESXi 7开启核显直通

以下这部分内容转载自这里 VMware vSphere（ESXI）7.X直通核显再重启ESXI后仍提示需要直通的解决办法。
自从VMware vSphere（ESXi）升级到7.0以后，改进了一个功能，就是硬件直通以后不需要重启就可以直接添加给虚拟机使用。可是偏偏有不少人会遇到以下情况：直通核显给虚拟机可以正常使用，但是ESXi重启后直通列表里面的核显会变成再次需要直通才能使用，这样的话设置的虚拟机自动启动就无效了。

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

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

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

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

esxcli system settings kernel set -s vga -v FALSE

4、重启ESXi生效。
N5105 BIOS 版本 ： V5.19

N5105 核心显卡的 Device ID ： 0x4e61

二、安装Debian 11 / Ubuntu 22（推荐Ubuntu)

在ESXi 7里新建一台虚拟机，建议分配4核CPU和2G~4G内存。我这里的启动设置是默认的BIOS启动，也有论坛玩家反馈需要设置为EFI启动才可以成功添加直通核显。先不要添加核显，用默认的虚拟显卡安装好Debian 11或者Ubuntu 22.04（推荐安装Ubuntu 22.04，因为不用自己折腾non-free的linux 固件），选择安装组件时不要选择任何GUI图形化桌面（如果安装了图形界面，后面直通核显时大概率死机），仅勾选安装SSH Server和基础组件，Ubuntu 要用ubuntu-22.04-live-server-amd64.iso这个安装包，选最小化安装，其他组件可以等安装完成后再apt install。

我在这里就先预留了所有内存，因为后面直通显卡设备有这个要求。也可以等直通显卡时再修改此项配置。

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

三、开启Debian 11 / Ubuntu 22 SSH登录

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

apt update && apt -y upgrade

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

apt -y install vim wget curl open-vm-tools

修改为静态IP

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

Debian 11 设置静态IP

vim /etc/network/interfaces

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

iface ens224 inet static
 address 192.168.1.18
 netmask 255.255.255.0
 gateway 192.168.1.1
 dns-nameservers 192.168.1.1 114.114.114.114

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

重启网络让新IP生效：

/etc/init.d/networking restart

Ubuntu 22 设置静态IP

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

vim /etc/netplan/00-installer-config.yaml

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

network:
  ethernets:
    ensxxx:
      addresses:
      - 192.168.1.18/24
      gateway4: 192.168.1.1
      nameservers:
        addresses:
        - 192.168.1.1
        - 114.114.114.114
  version: 2

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

重启网络让新IP生效：

netplan apply

开启root用户远程登录

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

apt -y install openssh-server

检查状态:

systemctl status ssh

确认SSH服务是enabled状态，可以开机自启动：

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

vim /etc/ssh/sshd_config

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

PermitRootLogin yes
PasswordAuthentication yes

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

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

sudo passwd root

重启SSH服务:

systemctl restart ssh

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

四、升级Debian 11 / Ubuntu 22 内核到5.18

升级Debian 11 内核到5.18

Debian 11安装好默认是5.10内核，根据Jellyfin中国特供版作者nyanmisaka等各位大佬的研究，想要让N5105核显开启硬件转码需要升级Linux内核到5.17以上，开启低功耗编码HuC和GuC。

到这里下载Debian 5.18内核二进制安装包，手动安装之。

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

mkdir kernel
cd kernel
wget http://ftp.debian.org/debian/pool/main/l/linux-signed-amd64/linux-image-5.18.0-2-amd64_5.18.5-1_amd64.deb
dpkg -i *.deb

查看已安装的内核:

dpkg --list | grep linux-image

返回：

ii  linux-image-5.10.0-16-amd64   5.10.127-1                     amd64        Linux 5.10 for 64-bit PCs (signed)
ii  linux-image-5.18.0-2-amd64    5.18.5-1                       amd64        Linux 5.18 for 64-bit PCs (signed)
ii  linux-image-amd64             5.10.127-1                     amd64        Linux for 64-bit PCs (meta-package)

重启：

reboot

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

uname -r

正常情况应该返回:

Linux debian 5.18.0-2-amd64

升级Ubuntu 22 内核到5.18

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

下载ubuntu-mainline-kernel脚本：

wget https://raw.githubusercontent.com/pimlie/ubuntu-mainline-kernel.sh/master/ubuntu-mainline-kernel.sh

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

install ubuntu-mainline-kernel.sh /usr/local/bin/

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

ubuntu-mainline-kernel.sh -r

返回：

<...省略...>
v5.18.0
v5.18.1
v5.18.2
v5.18.3
v5.18.4
v5.18.5
v5.18.6
v5.18.7
v5.18.8
v5.18.9
v5.18.10
v5.18.11
v5.18.12
v5.18.13
v5.18.14
v5.18.15
v5.18.16
v5.18.17
v5.18.18
v5.18.19
<...省略...>

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

ubuntu-mainline-kernel.sh -i v5.18.19

返回：

Downloading index from kernel.ubuntu.com
Will download 6 files from kernel.ubuntu.com:
Downloading amd64/linux-headers-5.18.19-051819-generic_5.18.19-051819.202208211443_amd64.deb: 100%
Downloading amd64/linux-headers-5.18.19-051819_5.18.19-051819.202208211443_all.deb: 100%
Downloading amd64/linux-image-unsigned-5.18.19-051819-generic_5.18.19-051819.202208211443_amd64.deb: 100%
Downloading amd64/linux-modules-5.18.19-051819-generic_5.18.19-051819.202208211443_amd64.deb: 100%
Downloading amd64/CHECKSUMS: 100%
Downloading amd64/CHECKSUMS.gpg: 100%
Signature of checksum file has been successfully verified
Checksums of deb files have been successfully verified with sha256sum
Installing 4 packages
Cleaning up work folder

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

ubuntu-mainline-kernel.sh -l

返回：

v5.18.19-051819

重启：

reboot

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

uname -r

返回:

5.18.19-051819-generic

代表新内核成功启用。

五、直通核显到Debian 11 / Ubuntu 22

添加核显PCI设备成为虚拟机硬件

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

禁用虚拟显卡

然后在虚拟机选项-高级-配置参数-编辑配置里，将svga.present由TRUE改为FALSE，保存并启动虚拟机。

开机后虚拟机控制台将一直呈现灰色而不可用，稍等片刻可以尝试SSH连接设置好的静态IP的22端口。如果不出意外，应该可以用root用户直接远程登录继续执行下面的操作。

验证核显是否已经加载：

ls -al /dev/dri

返回:

total 0
drwxr-xr-x  3 root root        100 Jul 15 22:07 .
drwxr-xr-x 17 root root       3200 Jul 15 22:07 ..
drwxr-xr-x  2 root root         80 Jul 15 22:07 by-path
crw-rw----  1 root video  226,   0 Jul 15 22:07 card0
crw-rw----  1 root render 226, 128 Jul 15 22:07 renderD128

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

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

安装缺失固件

Debian 11 安装缺失固件

因为开启核显开启HuC和GuC功能需要用到Intel提供的闭源已编译二进制固件，但是Debian默认的安装ISO镜像并不带这些non-free的Linux固件，虽然也可以从Debian官方下载下载包含non-free Linux固件的ISO镜像来进行安装，或者手动下载最新的20220718版non-free Linux固件安装包解压后安装，但经过我的测试，这两种方式安装的Intel核显i915 GuC固件版本还是偏低，需要到这里下载三个最新版本的固件：

固件	文件大小(Byte)	下载链接	MD5
ehl_guc_69.0.3.bin	343360	ehl_guc_69.0.3.bin	83dc91c3b5388066affc7bce49be96d8
ehl_huc_9.0.0.bin	498880	ehl_huc_9.0.0.bin	6438c08bef2e784a99837b9d1cb60989
icl_dmc_ver1_09.bin	25952	icl_dmc_ver1_09.bin	930d28514a198ca0eb39d9dfb743a194

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

mkdir /lib/firmware/i915

也可以直接在Debian里下载：

mkdir /lib/firmware/i915
cd /lib/firmware/i915
wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/i915/ehl_guc_69.0.3.bin
wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/i915/ehl_huc_9.0.0.bin
wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/i915/icl_dmc_ver1_09.bin

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

或者：

完成后注意核对文件大小和权限：

ls -l /lib/firmware/i915

返回：

-rw-r--r-- 1 root root 343360 Jul 14 21:56 ehl_guc_69.0.3.bin
-rw-r--r-- 1 root root 498880 Jul 14 22:03 ehl_huc_9.0.0.bin
-rw-r--r-- 1 root root  25952 Jul 14 21:55 icl_dmc_ver1_09.bin

在WinSCP里看是这样的：

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

mkdir firmware & cd firmware
wget https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/snapshot/linux-firmware-20220708.tar.gz
tar -zxf linux-firmware-20220708.tar.gz
mkdir /lib/firmware/i915
cp linux-firmware-20220708/i915/* /lib/firmware/i915/
rm -rf linux-firmware-20220708/

Ubuntu 22 检查固件

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

ls -l /lib/firmware/i915/ehl_guc_69*
ls -l /lib/firmware/i915/ehl_huc_9*
ls -l /lib/firmware/i915/icl_dmc_ver1_09*

返回：

-rw-r--r-- 1 root root 343360 May 13 11:44 /lib/firmware/i915/ehl_guc_69.0.3.bin
-rw-r--r-- 1 root root 498880 May 13 11:44 /lib/firmware/i915/ehl_huc_9.0.0.bin
-rw-r--r-- 1 root root 25952 May 13 11:44 /lib/firmware/i915/icl_dmc_ver1_09.bin

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

开启核显低功耗编码 HuC 和 GuC

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

vim /etc/default/grub

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

GRUB_CMDLINE_LINUX_DEFAULT="intel_iommu=on i915.enable_guc=3 quiet"

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

然后更新grub菜单:

update-grub

或者:

grub-mkconfig -o /boot/grub/grub.cfg

重启:

reboot

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

i915.enable_guc=1    ## 启用GuC提交和电源管理
i915.enable_guc=2    ## 只启用HuC认证
i915.enable_guc=3    ## 将两个功能结合在一起
##在内核4.16之前，HuC认证是通过设置：
i915.enable_guc_loading=1   ##4.16之前使用此参数开启huc认证

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

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

apt -y install intel-gpu-tools

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

journalctl -b -o short-monotonic -k | egrep -i "i915|dmr|dmc|guc|huc"

返回:

[    0.000000] debian kernel: Command line: BOOT_IMAGE=/boot/vmlinuz-5.18.0-2-amd64 root=UUID=1ac9bedb-49b8-4a86-b4e5-72b33eb78abd ro intel_iommu=on i915.enable_guc=3 quiet
[    0.043744] debian kernel: Kernel command line: BOOT_IMAGE=/boot/vmlinuz-5.18.0-2-amd64 root=UUID=1ac9bedb-49b8-4a86-b4e5-72b33eb78abd ro intel_iommu=on i915.enable_guc=3 quiet
[    3.509988] debian kernel: Setting dangerous option enable_guc - tainting kernel
[    3.509991] debian kernel: Setting dangerous option enable_guc - tainting kernel
[    3.511534] debian kernel: i915 0000:0b:00.0: [drm] VT-d active for gfx access
[    3.511543] debian kernel: i915 0000:0b:00.0: vgaarb: deactivate vga console
[    3.511906] debian kernel: i915 0000:0b:00.0: [drm] Transparent Hugepage mode 'huge=within_size'
[    3.514195] debian kernel: i915 0000:0b:00.0: Invalid PCI ROM header signature: expecting 0xaa55, got 0xffff
[    3.514202] debian kernel: i915 0000:0b:00.0: [drm] Failed to find VBIOS tables (VBT)
[    3.514250] debian kernel: i915 0000:0b:00.0: [drm] *ERROR* VBT claims to have both internal and external displays on PHY A.  Configuring for internal.
[    3.525794] debian kernel: i915 0000:0b:00.0: [drm] *ERROR* VBT claims to have both internal and external displays on PHY A.  Configuring for internal.
[    3.525952] debian kernel: i915 0000:0b:00.0: vgaarb: changed VGA decodes: olddecodes=io+mem,decodes=io+mem:owns=io+mem
[    3.527603] debian kernel: i915 0000:0b:00.0: firmware: direct-loading firmware i915/icl_dmc_ver1_09.bin
[    3.528081] debian kernel: i915 0000:0b:00.0: [drm] Finished loading DMC firmware i915/icl_dmc_ver1_09.bin (v1.9)
[    4.531068] debian kernel: i915 0000:0b:00.0: [drm] failed to retrieve link info, disabling eDP
[    4.532486] debian kernel: i915 0000:0b:00.0: firmware: direct-loading firmware i915/ehl_guc_69.0.3.bin
[    4.533796] debian kernel: i915 0000:0b:00.0: firmware: direct-loading firmware i915/ehl_huc_9.0.0.bin
[    4.695205] debian kernel: i915 0000:0b:00.0: [drm] GuC firmware i915/ehl_guc_69.0.3.bin version 69.0
[    4.695214] debian kernel: i915 0000:0b:00.0: [drm] HuC firmware i915/ehl_huc_9.0.0.bin version 9.0
[    4.709613] debian kernel: i915 0000:0b:00.0: [drm] HuC authenticated
[    4.709763] debian kernel: i915 0000:0b:00.0: [drm] GuC submission enabled
[    4.709766] debian kernel: i915 0000:0b:00.0: [drm] GuC SLPC disabled
[    4.712512] debian kernel: [drm] Initialized i915 1.6.0 20201103 for 0000:0b:00.0 on minor 0
[    6.089740] debian kernel: i915 0000:0b:00.0: [drm] Cannot find any crtc or sizes
[    6.090267] debian kernel: i915 0000:0b:00.0: [drm] *ERROR* VBT claims to have both internal and external displays on PHY A.  Configuring for internal.
[    7.459136] debian kernel: i915 0000:0b:00.0: [drm] Cannot find any crtc or sizes
[    7.459592] debian kernel: i915 0000:0b:00.0: [drm] *ERROR* VBT claims to have both internal and external displays on PHY A.  Configuring for internal.
[    8.863108] debian kernel: i915 0000:0b:00.0: [drm] Cannot find any crtc or sizes
[   21.078282] debian kernel: i915 0000:0b:00.0: [drm] *ERROR* VBT claims to have both internal and external displays on PHY A.  Configuring for internal.
[   21.078426] debian kernel: i915 0000:0b:00.0: [drm] *ERROR* VBT claims to have both internal and external displays on PHY A.  Configuring for internal.
[   31.311088] debian kernel: i915 0000:0b:00.0: [drm] *ERROR* VBT claims to have both internal and external displays on PHY A.  Configuring for internal.
[   31.314778] debian kernel: i915 0000:0b:00.0: [drm] *ERROR* VBT claims to have both internal and external displays on PHY A.  Configuring for internal.
[   32.698143] debian kernel: i915 0000:0b:00.0: [drm] *ERROR* VBT claims to have both internal and external displays on PHY A.  Configuring for internal.

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

[    4.532486] debian kernel: i915 0000:0b:00.0: firmware: direct-loading firmware i915/ehl_guc_69.0.3.bin
[    4.533796] debian kernel: i915 0000:0b:00.0: firmware: direct-loading firmware i915/ehl_huc_9.0.0.bin
[    4.695205] debian kernel: i915 0000:0b:00.0: [drm] GuC firmware i915/ehl_guc_69.0.3.bin version 69.0
[    4.695214] debian kernel: i915 0000:0b:00.0: [drm] HuC firmware i915/ehl_huc_9.0.0.bin version 9.0
[    4.709613] debian kernel: i915 0000:0b:00.0: [drm] HuC authenticated
[    4.709763] debian kernel: i915 0000:0b:00.0: [drm] GuC submission enabled

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

六、安装Docker

为Debian / Ubuntu 安装Docker

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

curl -fsSL https://get.docker.com | bash -s docker

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

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

检查：

docker ps -a

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

CONTAINER ID   IMAGE    COMMAND     CREATED      STATUS     PORTS    NAMES

安装docker-compose

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

curl -L "https://github.com/docker/compose/releases/download/v2.6.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

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

chmod +x /usr/local/bin/docker-compose

创建软链：

ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

执行完成后输入：

docker-compose --version

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

Docker Compose version v2.6.1

七、安装Jellyfin

安装准备

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

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

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

mkdir -p /opt/apps/jellyfin
cd /opt/apps/jellyfin
mkdir config cache media

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

cd /opt/apps/jellyfin
vim docker-compose.yml

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

version: '3'
services:
  jellyfin:
    image: nyanmisaka/jellyfin:latest
    container_name: jellyfin
    network_mode: host
    environment:
      - TZ=Asia/Shanghai
      - JELLYFIN_PublishedServerUrl=yourServer
    volumes:
      - ${PWD}/config:/config
      - ${PWD}/cache:/cache
      - ${PWD}/media:/media
    restart: unless-stopped
    privileged: true
    devices:
      - /dev/dri:/dev/dri

几点说明：

1. ${PWD}指的是当前目录/opt/apps/jellyfin，
   媒体文件夹${PWD}/media即相当于/opt/apps/jellyfin/media，下面我们会把远程共享文件夹直接挂载到这里。它映射到容器里的/media，记住容器和宿主机两个路径的对应关系，在设置jellyfin的时候会用到；
2. Docker image用的是nyanmisaka大佬开发的Jellyfin中国特供版的开发者的最新版，目前的版本是10.8.1，封装了核显驱动；
3. JELLYFIN_PublishedServerUrl需要改成本机的IP地址如192.168.1.18，不知道设置为127.0.0.1是否可以（未测试）；
4. devices: - /dev/dri:/dev/dri是把核显挂载到容器内部。
5. network用host，省去指定端口，http访问的默认端口是8096，如果需要映射到别的端口可以自行修改network_mode和添加ports映射，示例如下：

    version: '3'
    services:
      jellyfin:
        image: nyanmisaka/jellyfin:latest
        container_name: jellyfin
        network_mode: bridge
        ports:
          - 8096:8096
    	  - 8920:8920
          - 7359:7359/udp
          - 1900:1900/udp
        environment:
          - TZ=Asia/Shanghai
          - JELLYFIN_PublishedServerUrl=yourServer
        volumes:
          - ${PWD}/config:/config
          - ${PWD}/cache:/cache
          - ${PWD}/media:/media
        restart: unless-stopped
        privileged: true
        devices:
          - /dev/dri:/dev/dri

端口说明：

ports	说明
8096	WebUI http访问端口
8920	WebUI https访问端口
7359/udp	（可选）允许本地网络的客户端发现 Jellyfin
1900/udp	（可选）DLNA服务

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

启动Docker容器

输入命令启动Docker容器：

cd /opt/apps/jellyfin
docker-compose up -d

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

docker ps -a

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

CONTAINER ID   IMAGE                 COMMAND                  CREATED          STATUS                             PORTS     NAMES
002dc50b61a6   nyanmisaka/jellyfin   "./jellyfin/jellyfin…"   14 seconds ago   Up 12 seconds (health: starting)             jellyfin

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

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

docker exec -i -t  jellyfin /bin/bash

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

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

ls -al /dev/dri

返回：

total 0
drwxr-xr-x  2 root root        80 Jul 16 09:29 .
drwxr-xr-x 13 root root      2980 Jul 16 09:29 ..
crw-rw----  1 root video 226,   0 Jul 16 09:29 card0
crw-rw----  1 root   106 226, 128 Jul 16 09:29 renderD128

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

输入：

exit

退出容器。

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

八、挂载NFS远程视频文件

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

为Debian安装NFS客户端：

apt -y install nfs-common

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

mount -t nfs 192.168.1.19:/volume2/video /opt/apps/jellyfin/media

检查一下挂载是否成功：

df -hT

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

vim /etc/fstab

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

192.168.1.19:/volume2/video	/opt/apps/jellyfin/media	nfs rw,soft,intr       0 0

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

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

cd /opt/apps/jellyfin
docker-compose restart

或者先停止再启动

docker-compose stop
docker-compose up -d

九、设置jellyfin

访问http://Debian or Ubuntu的ip地址:8096例如http://192.168.1.18:8096，开始设置，具体设置方法可参考 群晖安装jellyfin最新10.8.0版本的教程。

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

媒体文件夹在容器内的路径是 /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：

CPU占用对比

日志验证

/usr/lib/jellyfin-ffmpeg/ffmpeg -analyzeduration 200M -ss 00:32:21.000 -init_hw_device vaapi=va:,driver=iHD,kernel_driver=i915 -init_hw_device qsv=qs@va -init_hw_device opencl=ocl@va -filter_hw_device qs -hwaccel vaapi -hwaccel_output_format vaapi -autorotate 0 -canvas_size 1920x1080 -i file:"/media/4k_uhd/狂野之美：国家公园探险.America.Wild.National.Parks.Adventure.2016.BluRay.2160p.x265.10bit.HDR.2Audio.mUHD-FRDS/America.Wild.National.Parks.Adventure.2016.BluRay.2160p.x265.10bit.HDR.2Audio.mUHD-FRDS.mkv" -map_metadata -1 -map_chapters -1 -threads 0 -map 0:0 -map 0:1 -codec:v:0 h264_qsv -low_power 1 -preset 7 -look_ahead 0 -b:v 9616000 -maxrate 9616000 -bufsize 19232000 -profile:v:0 high -level 51 -g:v:0 72 -keyint_min:v:0 72 -filter_complex "[0:3]scale=flags=fast_bilinear,format=bgra,hwupload=derive_device=qsv:extra_hw_frames=64[sub];[0:0]setparams=color_primaries=bt2020:color_trc=smpte2084:colorspace=bt2020nc,scale_vaapi=w=1920:h=1080,hwmap=derive_device=opencl,tonemap_opencl=format=nv12:p=bt709:t=bt709:m=bt709:tonemap=bt2390:peak=100:desat=0,hwmap=derive_device=qsv:reverse=1:extra_hw_frames=16,format=qsv[main];[main][sub]overlay_qsv=eof_action=endall:shortest=1:repeatlast=0:w=1920:h=1080" -start_at_zero -codec:a:0 libfdk_aac -ac 2 -ab 384000 -af "volume=2" -copyts -avoid_negative_ts disabled -max_muxing_queue_size 2048 -f hls -max_delay 5000000 -hls_time 3 -hls_segment_type mpegts -start_number 647 -hls_segment_filename "/config/transcodes/c2b53203519dbbad0f8d5dd9788b228e%d.ts" -hls_playlist_type vod -hls_list_size 0 -y "/config/transcodes/c2b53203519dbbad0f8d5dd9788b228e.m3u8"

Stream mapping:
  Stream #0:0 (hevc) -> setparams:default (graph 0)
  Stream #0:3 (pgssub) -> scale:default (graph 0)
  overlay_qsv:default (graph 0) -> Stream #0:0 (h264_qsv)
  Stream #0:1 -> #0:1 (truehd (native) -> aac (libfdk_aac))
Press [q] to stop, [?] for help

intel_gpu_top验证

执行：

intel_gpu_top

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

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

测试视频二

采用Jellyfish视频比特率测试文件，选择最高码率400Mbps的视频，29秒的视频文件大小达到1.4GB，无字幕：
jellyfish-400-mbps-4k-uhd-hevc-10bit.mkv

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

日志验证

十二、补充设置

延迟启动Docker

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

docker-compose restart

后错误消失。

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

取消Docker开机自启动

systemctl disable docker.service

用/etc/rc.local延迟启动Docker服务

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

cat <<EOF >/etc/rc.local
#!/bin/sh -e
#
# rc.local
#
# This script is executed at the end of each multiuser runlevel.
# Make sure that the script will "exit 0" on success or any other
# value on error.
#
# In order to enable or disable this script just change the execution
# bits.
#
# By default this script does nothing.

exit 0
EOF

然后赋予可执行权限：

chmod +x /etc/rc.local

接着启动 rc-local 服务：

systemctl enable --now rc-local

此时可能会弹出警告：

The unit files have no installation config (WantedBy=, RequiredBy=, Also=,
Alias= settings in the [Install] section, and DefaultInstance= for template
units). This means they are not meant to be enabled using systemctl.
 
Possible reasons for having this kind of units are:
• A unit may be statically enabled by being symlinked from another unit's
  .wants/ or .requires/ directory.
• A unit's purpose may be to act as a helper for some other unit which has
  a requirement dependency on it.
• A unit may be started when needed via activation (socket, path, timer,
  D-Bus, udev, scripted systemctl call, ...).
• In case of template units, the unit is meant to be enabled with some
  instance name specified.

不用管它，因为这个服务没有任何依赖的系统服务，只是开机执行 /etc/rc.local 脚本而已。

再次查看状态：

systemctl status rc-local.service 

返回：

● rc-local.service - /etc/rc.local Compatibility
 Loaded: loaded (/lib/systemd/system/rc-local.service; enabled-runtime; vendor preset: enabled)
Drop-In: /usr/lib/systemd/system/rc-local.service.d
         └─debian.conf
 Active: active (exited) since Sat 2022-07-16 12:27:14 HKT; 46s ago
   Docs: man:systemd-rc-local-generator(8)
Process: 37576 ExecStart=/etc/rc.local start (code=exited, status=0/SUCCESS)
    CPU: 1ms

Jul 16 12:27:14 debian systemd[1]: Starting /etc/rc.local Compatibility...
Jul 16 12:27:14 debian systemd[1]: Started /etc/rc.local Compatibility.

然后就可以把需要开机启动的命令添加到 /etc/rc.local 文件，放到在 exit 0 前面即可。

编辑/etc/rc.local文件：

vim /etc/rc.local

先按 i 进入编辑模式，在文件末尾exit 0 之前追加如下内容：

sleep 180
systemctl restart docker.service

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

说明：sleep 180的意思是延迟3分钟启动Docker，这里用restart是为了保证万一Docker已经被另外的脚本启动，就重启它。如果Docker还没有启动执行restart也会启动它。

重启服务器进行测试：

reboot

稍等几分钟，尝试访问jellyfin和播放视频，一切正常，马上开始愉快的看片吧。如果想在外网也能看，再设置一下upnp或在路由器上手动映射端口。

自动更新Docker镜像

nyanmisaka/jellyfin镜像更新很频繁，基本上每个月都有更新，修正bug改善性能，为了能够第一时间自动更新，我们引入watchtower，它可以自动检查指定的Docker镜像是否存在更新，通过email等方式发送更新提醒，也可以自动更新指定镜像。

watchtower可以使用Docker部署，用Docker管理Docker：

mkdir /opt/apps/watchtower
cd /opt/apps/watchtower
vim  docker-compose.yml

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

version: "3"
services:
  watchtower:
    image: containrrr/watchtower
    container_name: watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    command: jellyfin --cleanup --schedule "0 0 4 * * *"
    restart: always
    environment:
      - TZ=Asia/Shanghai
      - WATCHTOWER_MONITOR_ONLY='false'
      - WATCHTOWER_NOTIFICATIONS=email
      - WATCHTOWER_NOTIFICATION_EMAIL_FROM=sender_name@mailserver_domain.com
      - WATCHTOWER_NOTIFICATION_EMAIL_TO=receiver_name@mail_domain.com
      - WATCHTOWER_NOTIFICATION_EMAIL_SERVER=smtp.mailserver_domain.com
      - WATCHTOWER_NOTIFICATION_EMAIL_SERVER_PORT=587
      - WATCHTOWER_NOTIFICATION_EMAIL_SERVER_USER=sender_name@mailserver_domain.com
      - WATCHTOWER_NOTIFICATION_EMAIL_SERVER_PASSWORD=sender_mail_password

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

说明：

1. command解释：设定为每天凌晨4点自动检查容器jellyfin对应的镜像仓库中是否存在更新版本，如果有就自动更新它，并删除过时镜像，节约硬盘空间；
2. environment里有两个邮箱地址，FROM是发送提醒邮件的邮箱地址，TO是接受提醒邮件的邮箱地址，SERVER部分是发送提醒邮件的邮箱对应的邮件服务器SMTP资料，密码是明文存储，建议注册一个非主要邮箱来执行这个任务。

输入命令启动Docker容器：

cd /opt/apps/watchtower
docker-compose up -d

就会开始拉取镜像，并启动watchtower。
如果邮箱配置没有问题，会收到一封设置信息提醒邮件：

Watchtower 1.4.0
Using notifications: smtp
Only checking containers with name "jellyfin"
Scheduling first run: 2022-07-20 04:00:00 +0800 CST Note that the first check will be performed in 7 hours, 25 minutes, 31 seconds

如果仓库里的nyanmisaka/jellyfin镜像有更新，自动更新完成后会收到更新提醒邮件：

Found new nyanmisaka/jellyfin:latest image (e54a87b846cc)
Stopping /jellyfin (002dc50b61a6) with SIGTERM
Creating /jellyfin
Removing image 1b6d9d83f7c9

如果不出意外，更新后之前所有的设置都会保留，这样我们就能第一时间体验最新镜像了。

结语

到此为止，N5105作为一台家庭软路由主机，在底层安装EXSi虚拟化平台的基础上终于可以兼顾上网、轻Nas应用和视频硬件转码，基本上算是完美了。
再次感谢各位无私分享的大佬！如果你觉得nyanmisaka/jellyfin好用，欢迎向Jellyfin中国特供版的开发者nyanmisaka大佬捐赠。

文件下载

本文中涉及到的固件打包下载：

链接: https://pan.baidu.com/s/1WPiIH7u_jb9HV8gpC424XQ?pwd=aoe2 提取码: aoe2

参考文章

1. N5105 PVE docker-compose 安装Jellyfin 并实现 硬解码
2. N5015使用心得
3. Jellyfin中国特供版+Docker镜像，含驱动，免折腾开箱即用
4. 软路由N5105硬解方案归纳
5. 司波图 / 通用PVE AIO安装教程
6. N5105 jasper lake 开启硬件转码方法
7. 群晖安装jellyfin最新10.8.0版本的教程
8. N5105/N6005 群晖 核显解码 配置参考
9. 群晖用Jellyfin实现GPU硬解实时转码
10. 最新Jellyfin硬件转码教程丨威联通新平台有多强？4K转码只用20%
11. Jellyfish Video Bitrate Test Files
12. Centos7 延迟启动docker
13. Debian 11 Bullseye 解决 /etc/rc.local 开机启动问题
14. VMware vSphere（ESXI）7.X直通核显再重启ESXI后仍提示需要直通的解决办法
15. Ubuntu 20.04 升级最新内核、安装指定内核版本
16. Ubuntu20.04修改ip地址的方法示例