N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)

摘要

在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折腾经历
  • 一、ESXi 7开启核显直通
  • 二、安装Debian 11 / Ubuntu 22(推荐Ubuntu)
  • 三、开启Debian 11 / Ubuntu 22 SSH登录
    • 修改为静态IP
      • Debian 11 设置静态IP
      • Ubuntu 22 设置静态IP
    • 开启root用户远程登录
  • 四、升级Debian 11 / Ubuntu 22 内核到5.18
    • 升级Debian 11 内核到5.18
    • 升级Ubuntu 22 内核到5.18
  • 五、直通核显到Debian 11 / Ubuntu 22
    • 添加核显PCI设备成为虚拟机硬件
    • 禁用虚拟显卡
    • 安装缺失固件
      • Debian 11 安装缺失固件
      • Ubuntu 22 检查固件
    • 开启核显低功耗编码 HuC 和 GuC
  • 六、安装Docker
    • 为Debian / Ubuntu 安装Docker
    • 安装docker-compose
  • 七、安装Jellyfin
    • 安装准备
    • 启动Docker容器
  • 八、挂载NFS远程视频文件
  • 九、设置jellyfin
  • 十、开启硬件转码
  • 十一、验证硬件转码效果
    • 测试视频一
      • 关闭硬件转码测试
      • 开启硬件转码测试
      • CPU占用对比
      • 日志验证
      • intel_gpu_top验证
    • 测试视频二
      • 日志验证
  • 十二、补充设置
    • 延迟启动Docker
      • 取消Docker开机自启动
      • 用`/etc/rc.local`延迟启动Docker服务
    • 自动更新Docker镜像
  • 结语
  • 文件下载
  • 参考文章

我的N5105折腾经历

我的N5105软路由是2022年4月底入手的,我也不清楚算是第几版,主板型号是 MW-JSL2.5G-4L,两个内存插槽,两个USB3.0,1个Nvme接口,1个mini-PCIe接口,1组SATA电源+数据接口,另外主板上还预留有两个USB2.0接口的扩展插座和一个12V风扇插座(实测不支持PMW调速)。
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第1张图片
到手时BIOS就是传说中可以直通核显的版本v5.19
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第2张图片
但是当我在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 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第3张图片
N5105 核心显卡的 Device ID : 0x4e61
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第4张图片

二、安装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
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第5张图片
我在这里就先预留了所有内存,因为后面直通显卡设备有这个要求。也可以等直通显卡时再修改此项配置。

注意:不要选择任何GUI图形化桌面
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第6张图片

三、开启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 一行里的dhcpstaticensxxx要和你的实际网卡名字保持一致,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状态,可以开机自启动:
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第7张图片
修改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设备添加到虚拟机的硬件里:

N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第8张图片

禁用虚拟显卡

然后在虚拟机选项-高级-配置参数-编辑配置里,将svga.presentTRUE改为FALSE,保存并启动虚拟机。
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第9张图片
开机后虚拟机控制台将一直呈现灰色而不可用,稍等片刻可以尝试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。
从这里下载:
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第10张图片
或者:
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第11张图片
完成后注意核对文件大小和权限:

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里看是这样的:
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第12张图片
补充:(可选,非必须)如果想安装完整版的最新固件,可以从这里下载(压缩包文件大小达近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=2GuC 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,并在该处新建三个挂载文件夹configcachemedia

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设置教程)。以下的设置仅供参考:
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第13张图片
为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,以此类推。

十、开启硬件转码

按下面的图片内容来设置硬件转码,设置完保存即可:
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第14张图片

十一、验证硬件转码效果

测试视频一

测试片源America.Wild.National.Parks.Adventure.2016.BluRay.2160p.x265.10bit.HDR.2Audio.mUHD-FRDS.mkv,带字幕:
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第15张图片

关闭硬件转码测试

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

Log of Software Decode / Encode for M1 Large

开启硬件转码测试

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

Log of Hardware Decode / Encode for M1 Large

CPU占用对比

N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第16张图片

日志验证

/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

查看核显解码时的运行状态:
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第17张图片

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

测试视频二

采用Jellyfish视频比特率测试文件,选择最高码率400Mbps的视频,29秒的视频文件大小达到1.4GB,无字幕:
jellyfish-400-mbps-4k-uhd-hevc-10bit.mkv
jellyfish-400-mbps-4k-uhd-hevc-10bit.mkv
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第18张图片

还是转码为1080p 10Mbps H264视频,转码帧率44fps:
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第19张图片

日志验证

N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第20张图片

十二、补充设置

延迟启动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 </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或在路由器上手动映射端口。
N5105 软路由安装 ESXi 7 直通核显给 Debian / Ubuntu 虚拟机通过 Docker 实现 jellyfin 硬件转码视频文件(硬解/编码)_第21张图片

自动更新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地址的方法示例

你可能感兴趣的:(linux,debian,docker,linux,视频编解码,音视频)