在 TrueNAS SCALE 上搭建 Jellyfin：直通 GPU 的踩坑记录

需求很简单：在客厅电视流畅看 4K，尽量让 iGPU 硬解，CPU 不要狂飙。下面是我在 TrueNAS SCALE 23.10 上折腾 Jellyfin 的步骤和坑。

环境 & 硬件

• TrueNAS SCALE 23.10（基于 Debian Bookworm）
• 英特尔 N100 + iGPU
• Jellyfin 官方 docker 镜像

关键步骤

1. BIOS 开 VT-d，SATA 模式保持 AHCI。
2. 在 TrueNAS Shell 里编辑 /etc/default/grub，追加 intel_iommu=on，然后 update-grub && update-initramfs -u，重启。
3. 重启后 lspci | grep -i vga 能看到 iGPU。
4. docker-compose 示例（Apps 里创建 Stack）：

version: "3.9"
services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    volumes:
      - /mnt/tank/media:/media
      - /mnt/tank/config/jellyfin:/config
    devices:
      - /dev/dri:/dev/dri
    environment:
      - JELLYFIN_PublishedServerUrl=http://nas.local:8096
    ports:
      - "8096:8096"
    restart: unless-stopped

坑点

• 没有开启 VT-d 会导致 /dev/dri 缺失，Jellyfin 里硬解选项直接灰掉。
• HDR 转 SDR 的 Tone Mapping 对 iGPU 压力不小，电视端能直播就直播。
• 转码时 CPU 仍会占用 30% 左右，记得给 Transmission/qBittorrent 限速，否则会争资源。

效果

4K HDR → 1080p 的在线转码，CPU 占用 ~40%，iGPU 占用 ~60%，温度可控。客厅电视播放流畅，老婆和猫都满意。