跳至主内容
非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

已知的硬件加速问题与限制

本页面列出了 Jellyfin 硬件加速的所有已知问题与限制。

Windows 下的 AMD 显卡问题​

  1. AMD Radeon RX 5000 及更新的 RDNA 系列集成/独立显卡存在 Windows 显卡驱动问题，影响范围从 Adrenalin 24.1.1 到 24.4.1。在转码和播放视频时，您可能会遇到播放失败，并在 FFmpeg 日志中观察到 -60 错误码。Adrenalin 24.5.1 及更新的驱动程序已修复此问题。

Linux 下的 AMD 显卡问题​

  1. 部分 Linux 发行版在 Mesa VA-API 驱动中禁用了 H.264 和 HEVC 编解码器。

    已知受影响的发行版：

    这将导致服务器系统无法使用 AMD VA-API 转码功能。

    替代方案：

    • 使用我们的 Docker 镜像
    • 安装第三方 Mesa 驱动包
    • 或重新编译 Mesa 驱动并添加以下参数以恢复被移除的硬件编解码器：
    -D video-codecs=all

Windows 下的 Intel 显卡问题​

  1. 英特尔第 11 代及更新的 UHD、Xe 和 ARC 系列集成/独立显卡存在 Windows 显卡驱动问题，影响范围从 31.0.101.5186 / 31.0.101.5234 到 31.0.101.5534。在转码和播放需要色调映射的 HDR 视频时，您可能会遇到绿屏或蓝屏但声音正常的现象。31.0.101.5590 及更新的驱动程序已修复此问题。

Linux 下的 Intel 显卡问题​

  1. Intel 第 11 代 Jasper Lake 和 Elkhart Lake 平台（如 N5095/N5105/N6005/J6412）在 Linux 下使用视频编码器存在异常。必须配置并启用低功耗编码模式才能实现 Jellyfin 所需的正确 VBR/CBR 码率控制。

  2. Ubuntu 22.04 LTS 默认内核 5.15 在 Intel 第 11 代显卡（ICL/JSL/EHL）上存在回归问题，导致无法使用低功耗编码模式。Linux 5.16+ 不受影响。

    sudo apt install --install-recommends linux-generic-hwe-22.04

    注意：此操作将使系统脱离 5.15 内核（可能带来其他影响）。若出现问题，可通过安装 linux-generic 包回滚至标准内核。

  3. 内核版本 5.18 至 6.1.3 存在缺陷：使用基于 OpenCL 的 HDR/DV 色调映射时会导致 i915 内核驱动锁死并重置。Linux 5.18- / 6.0.18+ / 6.1.4+ 不受影响。

  4. 当前 Debian 11 和 Ubuntu 22.04 LTS 可能缺少 Intel 第 12 代处理器和 ARC GPU 所需的 GPU 固件。Ubuntu 22.04 LTS 可切换到硬件支持增强栈（参见上文第 2 点），该栈使用的新内核支持 Intel 第 12 代及以上处理器和 ARC GPU。

  5. Linux 5.9 之前的内核对 Intel 第 12 代 TGL 显卡的支持不完善。

  6. Linux 6.17 之前的内核对 Intel 第 12 代 DG1 的支持不完善。

  7. Linux 5.17 之前的内核对 Intel 第 12 代 ADL 显卡的支持不完善（ADL-N Refresh N150/N250/N350 iGPU 需要 Linux 6.9+）。

  8. Linux 6.2 之前的内核对 Intel 第 12.5 代 DG2 / ARC A 系列的支持不完善。

  9. Linux 6.7 之前的内核对 Intel 第 12.7 代 MTL 的支持不完善。

  10. Linux 6.11 之前的内核对 Intel 第 12.7 代 ARL 的支持不完善。

  11. Linux 6.12 之前的内核对 Intel 第 13 代（或第 20 代？）LNL 和 BMG / ARC B 系列的支持不完善。

  12. LTS 内核版本 6.6.26 - 6.6.32 和稳定内核版本 6.8.5 - 6.9.3 存在 i915 驱动缺陷，可能导致 Intel 第 12.5 代 DG2 / ARC A 系列 GPU 出现问题。若您受影响，请升级至内核 6.6.33+（LTS）或 6.9.4+。使用 6.8.0-38 至 6.8.0-41 内核的 Ubuntu 24.04 同样受此影响，请升级至 Ubuntu 内核 6.8.0-44+。

  13. Intel Compute-Runtime 从 25.18.33578.6 开始的版本在特定 GPU 上存在缺陷，该问题已在 Arc A 系列 GPU 上确认。若您使用受影响型号，需安装最新可用版本 25.13.33276.16，直到此问题修复。此问题也可能影响容器环境——若未使用官方镜像，请检查容器内的运行时版本。

  14. BMG / ARC B 系列显卡必须启用 Resizable-BAR 才能使用硬件加速，否则媒体驱动会导致转码器崩溃。

  15. Intel Compute-Runtime 当前使用 LLVM 14 进行编译详见 Intel 缺陷报告，导致其在部分发行版（如 Debian Trixie）不可用详见 Debian 缺陷报告。您可改用 Intel 在官方 GitHub 页面提供的预编译版本，该版本仅需匹配 libc 运行时环境。

NVIDIA​

  1. 面向消费级的 GeForce 和部分入门级 Quadro 显卡对 NVENC 并发编码会话数设有人为限制。可通过应用非官方补丁绕过此限制（适用于 NVIDIA Linux/Windows 驱动）。

    NVIDIA 驱动版本NVENC 并发会话数
    550 及更新版本最多 8 个会话
    530 至 546最多 5 个会话
    530 之前版本最多 3 个会话

  2. 在容器环境（如 Docker、LXC）中使用 NVIDIA GPU 时，容器可能随机失去 GPU 访问权限。部分临时解决方案参考：

  3. Nvidia Container Toolkit 不支持 Docker Desktop。