一次 Intel iGPU 硬件编码失效的排查：GuC / HuC / firmware 才是关键

前言#

鄙人最近开始优化Homelab架构，打算做算存分离，遂把Jellyfin等容器开始移向我的N5095小主机上，但存在无法硬件编码的情况，排查了一下午，换了许多的镜像都无法成功，故折腾了一翻，才有了这篇文章，旨在帮助后人在再次遇到此类问题时能有些许帮助

正文#

环境#

硬件平台：

CPU：Intel Jasper Lake N5095（Gen11 iGPU）
无独显

系统环境：

Debian 13 (trixie)
Kernel: 6.12.x
Docker + docker-compose

服务：

Jellyfin（nyanmisaka/jellyfin）
使用 QSV / VAAPI 硬件转码

现象描述#

鄙人在转移服务时，发现同一套Jellyfin配置下，在QNAP-464C2（同样也是N5095）上可以正常运行硬件编码，但是在Debian13上无法播放，FFmpeg日志中只有一句：

1
FFmpeg exited with code 234

在尝试关闭硬件编码后，一切正常，但性能很烂，QSV解码+软件编码在4K80Mbps HDR10 转码20Mbps SDR色调映射时转码帧率只有20，而且CPU打满影响其他容器，这肯定是无法满足正常需求的已经确定的是：

QSV解码能正常运行
/dev/dri/renderD128在容器中是存在的
vainfo在容器中也是正常的
intel_gpu_top也能正常看到有调用

一切都指向硬件解码是完好的，但硬件编码就是无法正常使用

突破点#

我在QNAP上排查到这一步时：

1
sudo dmesg | grep -i guc
2
sudo dmesg | grep -i huc

结果中有部分是这样的:

1
[    5.960585] [drm] GuC communication enabled
2
[    5.971545] i915 0000:00:02.0: [drm] GuC firmware i915/ehl_guc_33.0.4.bin version 33.0 submission:disabled
3
[    5.982316] i915 0000:00:02.0: [drm] HuC firmware i915/ehl_huc_9.0.0.bin version 9.0 authenticated:yes

然后我在Debian上敲了一样的命令，发现什么都没有，感觉完全没有加载查询了一下，Debian没有安装Intel的非自由固件

解决方案#

安装固件包

1
sudo apt update
2
sudo apt install firmware-misc-nonfree firmware-intel-misc

装完后查看

1
ls /lib/firmware/i915/ | grep ehl

应当能看到

1
ehl_guc_70.1.1.bin
2
ehl_huc_9.0.0.bin

修改GRUB，添加i915.enable_guc=3

1
GRUB_CMDLINE_LINUX_DEFAULT="quiet i915.enable_guc=3"

更新GRUB并重启

1
sudo update-grub
2
sudo reboot

重启后再次查看dmesg，应当看到类似以下的内容

1
[   34.982106] Setting dangerous option enable_guc - tainting kernel
2
[   36.726000] i915 0000:00:02.0: [drm] GT0: GuC firmware i915/ehl_guc_70.1.1.bin version 70.1.1
3
[   36.742212] i915 0000:00:02.0: [drm] GT0: GUC: submission enabled
4
[   36.742214] i915 0000:00:02.0: [drm] GT0: GUC: SLPC disabled
5
[   36.726021] i915 0000:00:02.0: [drm] GT0: HuC firmware i915/ehl_huc_9.0.0.bin version 9.0.0
6
[   36.741869] i915 0000:00:02.0: [drm] GT0: HuC: authenticated for all workloads

Jellyfin配置参考#

docker-compose.yml:

1
services:
2
  jellyfin:
3
    image: nyanmisaka/jellyfin:latest
4
    container_name: Jellyfin
5
    privileged: true
6
    network_mode: host
7
    restart: unless-stopped
8
    devices:
9
      - /dev/dri/renderD128:/dev/dri/renderD128
10
    volumes:
11
      - ./config:/config
12
      - ./cache:/cache
13
      - ./media:/media
14
      - /etc/localtime:/etc/localtime:ro
15
    environment:
16
      - TZ=Asia/Shanghai

jellyfin: 图片.png

寻径

前言#

正文#

环境#

现象描述#

突破点#

解决方案#

Jellyfin配置参考#

继续浏览

换条路线

寻径

前言#

正文#

环境#

现象描述#

突破点#

解决方案#

Jellyfin配置参考#

分享文章

换条路线