Jellyfin 播 4K 卡成幻灯片,CPU 占用 100%——这是新手最常遇到的问题。

原因几乎都是:没用硬件解码,全靠 CPU 软解。

这篇把三个平台的硬解配置写清楚:Intel 核显、AMD 核显、NVIDIA 独显。每步都有验证命令。

先理解:为什么需要硬解

方式 谁来解码 4K 转码时的 CPU 占用 功耗
软解(CPU) CPU 100%,可能卡顿 高
硬解(GPU) 核显/独显专用单元 10-30% 低

关键概念:

  • 直接播放(Direct Play):客户端能解,服务器只传文件,不转码。这是最好的情况。
  • 转码(Transcode):客户端解不了(格式不支持、带宽不够、分辨率不匹配),服务器要实时转换。

硬解只在转码时有用。如果你的客户端都能直接播放,不需要配硬解。

判断要不要转码

Jellyfin 播放时点右上角「齿轮」→「播放信息」,看:

显示 含义
Direct Play ✅ 直接播放,无转码
Direct Stream ⚠️ 只转封装,不转码(很轻)
Transcode ❌ 正在转码,需要硬解

常见需要转码的场景:

  • 4K HDR 视频,客户端不支持 HDR
  • 高码率视频,外网带宽不够
  • 音频格式客户端不支持(如 DTS → AAC)
  • 字幕烧录(图像字幕必须转码)

平台一:Intel 核显(最推荐)

支持范围:Intel 7 代(Kaby Lake)及以上

代际 型号示例 支持编码 备注
7-9 代 i5-7400, i5-9600 H.264, HEVC 8bit 基础
10-11 代 i5-10400, i5-11400 + HEVC 10bit, VP9 推荐
12 代+ i5-12400, N100 + AV1 解码 最好

N100/N305 是当前性价比之王:支持 AV1 硬解,功耗 6-15W。

Docker 配置

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    restart: unless-stopped
    ports:
      - "8096:8096"
    volumes:
      - /opt/jellyfin/config:/config
      - /opt/jellyfin/cache:/cache
      - /mnt/media:/media:ro
    devices:
      # 关键:把核显设备映射进容器
      - /dev/dri:/dev/dri
    group_add:
      # 关键:加进 video 和 render 组,否则没权限
      - "989"   # video 组 GID,用 getent group video 查
      - "990"   # render 组 GID,用 getent group render 查
    environment:
      - TZ=Asia/Shanghai
      - PUID=1000
      - PGID=1000

查 GID:

getent group video
# 输出:video:x:44:    ← 44 是 GID

getent group render
# 输出:render:x:990:  ← 990 是 GID

不同发行版 GID 不同,Ubuntu 通常是 44/109,Debian 是 44/107,群晖是 937/937。必须用实际查到的值。

验证

# 1. 确认宿主机能看到核显
ls -l /dev/dri/
# 应该看到 card0 和 renderD128

# 2. 确认容器内也能看到
docker exec -it jellyfin ls -l /dev/dri/

# 3. 确认容器内用户有权限
docker exec -it jellyfin id
# 应该包含 video 和 render 组

# 4. 看 Jellyfin 日志
docker logs jellyfin 2>&1 | grep -i "vaapi\|qsv\|hardware"

Jellyfin 后台配置

控制台 → 播放 → 转码:

设置项 值
硬件加速 Intel QuickSync (QSV) 或 VAAPI
启用硬件解码 勾选所有支持的格式
启用硬件编码 勾选 H.264、HEVC
启用低电压解码 勾选(省电,但可能不稳定)
转码路径 /dev/shm(内存盘,减少 SSD 磨损)
转码线程数 0(自动)

QSV vs VAAPI:

  • QSV:Intel 专用,性能更好,支持更多特性
  • VAAPI:通用 Linux 接口,兼容性好

建议先试 QSV,不行再用 VAAPI。

验证是否真的硬解

播放一个需要转码的视频,然后:

# 方法一:看 Jellyfin 播放信息
# 播放界面 → 齿轮 → 播放信息 → 看 "Transcoding" 部分
# 应该显示 "(HW)" 或 "QuickSync"

# 方法二:看 GPU 占用
intel_gpu_top
# 如果没装:apt install intel-gpu-tools

# 方法三:看 CPU 占用
docker stats jellyfin
# 硬解时 CPU 应该低于 30%

平台二:AMD 核显

支持范围:AMD APU(Ryzen 2000G 系列及以上)

系列 支持 备注
Ryzen 2000G/3000G H.264, HEVC 8bit 基础
Ryzen 5000G/7000 系 + HEVC 10bit, AV1 解码 推荐

限制:AMD 在 Linux 下的硬解支持不如 Intel 成熟,某些格式可能失败。

Docker 配置

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    devices:
      - /dev/dri:/dev/dri
    group_add:
      - "video"
      - "render"
    # AMD 需要额外挂载
    volumes:
      - /dev/kfd:/dev/kfd   # 计算设备(某些功能需要)

需要装驱动

# Debian/Ubuntu
apt install -y mesa-va-drivers mesa-vdpau-drivers vainfo

# 验证
vainfo
# 应该输出支持的编码格式列表

Jellyfin 配置

硬件加速选 VAAPI(AMD 用 VAAPI,不是 QSV)。

平台三:NVIDIA 独显

适用:有独立显卡的机器(GTX 1050 及以上)

优势:性能最强,支持同时转码多路

劣势:功耗高,需要额外配置,消费级卡有并发限制(官方限制 2-3 路,可破解)

1. 装驱动

# Debian/Ubuntu
apt install -y nvidia-driver-535

# 验证
nvidia-smi

2. 装 NVIDIA Container Toolkit

# 添加源
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | \
  sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg

curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | \
  sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | \
  sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list

apt update
apt install -y nvidia-container-toolkit

# 配置 Docker
nvidia-ctk runtime configure --runtime=docker
systemctl restart docker

3. Docker 配置

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all          # 或指定 1
              capabilities: [gpu, video, compute]

4. 验证

# 容器内能看到 GPU
docker exec -it jellyfin nvidia-smi

5. Jellyfin 配置

硬件加速选 NVENC。

破解并发限制

消费级 N 卡官方限制 2-3 路同时转码。破解补丁:

# 项目:https://github.com/keylase/nvidia-patch
# 注意:这是修改驱动,有风险,自行判断

# Docker 方式更简单,用已经打过补丁的镜像
# 但镜像来源需要自己判断可信度

我的建议:家用场景 2-3 路够用,不必破解。

三个平台对比

项目 Intel 核显 AMD 核显 NVIDIA 独显
配置难度 低 中 高
功耗 低(6-15W) 低 高(50-200W)
转码性能 够用 够用 最强
同时转码路数 3-5 路 2-4 路 受驱动限制
格式支持 最全(含 AV1) 中等 全
成本 集成 集成 额外 1000+
推荐度 ⭐⭐⭐⭐⭐ ⭐⭐⭐ ⭐⭐(除非已有)

结论:家用首选 Intel 核显(N100 或 12 代以上 i3/i5),性价比和易用性最好。

常见问题排查

问题 1:配置了硬解,但 CPU 还是 100%

排查:

# 1. 容器内能看到设备吗
docker exec -it jellyfin ls -l /dev/dri/
# 如果没有输出,说明 devices 映射没生效

# 2. 容器内用户有权限吗
docker exec -it jellyfin id
# 没看到 video/render 组 → group_add 配错了

# 3. Jellyfin 日志有报错吗
docker logs jellyfin 2>&1 | grep -iE "error|fail|permission"

最常见原因:group_add 里的 GID 和宿主机实际不符。

问题 2:硬解开了但播放花屏

原因:驱动版本不匹配,或者低电压解码不稳定。

解决:

  1. Jellyfin 设置里关掉「低电压解码」
  2. 更新内核和 Mesa 驱动
  3. 换 VAAPI 试试(如果之前用 QSV)

问题 3:某些格式无法硬解

原因:硬件不支持该编码。

查支持列表:

# Intel
vainfo | grep -i "hevc\|av1\|vp9"

# 或者查 Intel 官方文档
# https://en.wikipedia.org/wiki/Intel_Quick_Sync_Video

解决:让 Jellyfin 只对支持的格式用硬解,不支持的走软解。

问题 4:转码时容器崩溃

原因:通常是 /dev/dri 权限问题,或者内存不足。

排查:

# 看容器退出原因
docker inspect jellyfin | grep -A 5 "State"

# 看系统日志
dmesg | tail -30

转码性能实测

测试环境:N100(4 核,16G 内存),Jellyfin 10.10

场景 软解 CPU 硬解 CPU 流畅度
1080p H.264 → 720p 65% 8% 都流畅
4K HEVC → 1080p 100%(卡) 22% 硬解流畅
4K HEVC 10bit HDR → 1080p SDR 不可能 35% 硬解可播
同时 3 路 4K 转码 崩溃 70% 硬解可跑

结论:硬解让 N100 从「播不了 4K」变成「能同时转 3 路 4K」。

一句话总结

硬解配置的核心是三件事:

  1. 映射设备:devices: - /dev/dri:/dev/dri
  2. 给权限:group_add 里加 video 和 render 组的实际 GID
  3. 后台开启:Jellyfin 控制台选对硬件加速类型

三个平台里,Intel 核显最容易配、最省电、格式支持最全。如果还没买硬件,直接选 N100 或 12 代 i3。

最后提醒:先确认你的场景真的需要转码。如果客户端都能直接播放,配硬解是白费功夫。