温馨提示×

ubuntu jellyfin怎样转码

小樊
53
2026-10-22 14:50:48
栏目: 智能运维

在 Ubuntu 上让 Jellyfin 正常转码,通常需要做以下几步。下面按「最常见、最容易踩坑」的顺序说明。


一、确认 Jellyfin 版本与安装方式

先确认你是哪种安装方式:

dpkg -l | grep jellyfin

常见有:

  • 官方 deb 包(推荐)
  • Docker
  • 源安装(apt)

后面配置略有不同,但核心都是:FFmpeg + 权限 + 硬件驱动


二、安装 FFmpeg(关键)

Jellyfin 转码依赖 FFmpeg。

1. 推荐安装 Jellyfin 官方 FFmpeg(最重要)

sudo apt install jellyfin-ffmpeg

验证:

which ffmpeg
# 正常应为 /usr/lib/jellyfin-ffmpeg/ffmpeg

2. 在 Jellyfin 中指定 FFmpeg 路径

Dashboard → Playback → Transcoding

  • FFmpeg path:
/usr/lib/jellyfin-ffmpeg/ffmpeg

三、开启转码(软件转码)

如果只是 CPU 转码(软解):

Dashboard → Playback → Transcoding
✅ Enable video transcoding
✅ Enable audio transcoding

选支持的格式(如 H264 / H265)


四、硬件转码(推荐,省 CPU)

1. 查看你的显卡

lspci | grep -i vga

常见:

  • Intel → VAAPI / QSV
  • NVIDIA → NVENC
  • AMD → VAAPI

2. Intel 核显(最常见)

安装驱动

sudo apt install intel-media-va-driver-non-free vainfo

验证:

vainfo

看到 VA-API 即成功

用户加入 video 组

sudo usermod -aG video jellyfin

⚠️ 如果是 Docker,需要映射 /dev/dri

Jellyfin 设置

Dashboard → Playback → Transcoding
✅ Intel QuickSync (QSV)
或
✅ VAAPI


3. NVIDIA 显卡(NVENC)

安装驱动

ubuntu-drivers autoinstall

安装 NVENC 支持(Jellyfin FFmpeg 已包含)

Jellyfin 设置

✅ NVIDIA NVENC

Docker 需:

devices:
  - /dev/nvidia0
  - /dev/nvidiactl

五、Docker 用户特别注意(很多人失败在这)

docker-compose 示例(Intel)

devices:
  - /dev/dri:/dev/dri
environment:
  - JELLYFIN_PublishedServerUrl=192.168.1.100

权限

sudo usermod -aG video jellyfin
sudo chmod 666 /dev/dri/renderD128

六、测试转码

播放一个 不支持直接播放 的视频(如 4K HEVC)

  • 浏览器按 Ctrl+Shift+I
  • 看 Jellyfin 是否显示:
Transcoding (H264)

七、常见问题速查

问题 原因
转码失败 FFmpeg 路径错
黑屏 权限不够
CPU 100% 没开硬件转码
Docker 不转码 没映射 /dev/dri

如果你愿意,可以告诉我:

  • Ubuntu 版本
  • Jellyfin 安装方式
  • 显卡型号

我可以直接给你 一份可直接用的配置。

0 踩