Jellyfin硬件加速报错iHD_drv_video.so初始化失败求助

核心问题分析 #

你的Intel Core i5-3337U属于Ivy Bridge架构，仅支持i965 VA-API驱动，而容器内默认加载的iHD驱动是针对Skylake及以后的新Intel显卡的，因此会出现初始化失败的错误。OpenCL获取失败也和硬件本身的支持范围、驱动匹配度直接相关。

解决步骤 #

1. 强制容器使用i965驱动 #

临时测试（容器内执行）

进入容器后手动指定驱动环境变量：

docker exec -it jellyfin bash
export LIBVA_DRIVER_NAME=i965
# 重新测试ffmpeg命令
/usr/lib/jellyfin-ffmpeg/ffmpeg -v verbose -init_hw_device vaapi=va -init_hw_device opencl@va

永久配置（修改docker-compose.yml）

在Jellyfin服务配置中添加环境变量，确保挂载DRI设备：

services:
  jellyfin:
    # 原有配置...
    environment:
      - LIBVA_DRIVER_NAME=i965
    devices:
      - /dev/dri/renderD128:/dev/dri/renderD128
      - /dev/dri/card0:/dev/dri/card0

修改后重启容器：docker-compose up -d

2. 验证VA-API驱动匹配 #

执行命令确认驱动加载正常：

docker exec -it jellyfin /usr/lib/jellyfin-ffmpeg/vainfo

若输出显示Driver version: Intel i965 driver for Intel(R) IvyBridge Mobile（版本号可能略有不同），说明驱动匹配成功。

3. 修复OpenCL支持问题 #

Ivy Bridge仅支持OpenCL 1.1，需安装对应运行时：

容器内临时安装

docker exec -it jellyfin bash
apt update && apt install -y intel-opencl-icd && rm -rf /var/lib/apt/lists/*

安装完成后重新测试OpenCL初始化命令。

永久集成（自定义镜像）

如果需要长期生效，可基于官方镜像构建自定义镜像：

FROM jellyfin/jellyfin:latest
RUN apt update && apt install -y intel-opencl-icd && rm -rf /var/lib/apt/lists/*

之后修改docker-compose.yml使用自定义镜像。

4. Jellyfin后台配置验证 #

登录Jellyfin后台，进入控制台 -> 播放 -> 硬件加速：

• 选择VA-API作为硬件加速方式
• 若OpenCL配置成功，可按需勾选启用OpenCL硬件编码
• 保存后测试视频播放，通过docker logs jellyfin搜索hwaccel关键字，确认硬件加速是否生效

注意事项 #

• Ivy Bridge仅支持H.264等常见编码的硬件加速，不支持H.265等新编码
• 确保宿主机已安装intel-media-va-driver-non-free或对应i965的驱动包，容器依赖宿主机的DRI设备驱动

内容的提问来源于stack exchange，提问作者Hitit