温馨提示×

ubuntu jellyfin如何转码

小樊
43
2026-09-29 05:06:28
栏目: 智能运维

在 Ubuntu 上让 Jellyfin 正常转码,核心是确保 FFmpeg 可用 + 权限正确 + 硬件加速(可选)配置好。下面按「基础转码 → 硬件加速 → 常见问题」说明。


一、基础转码(软件转码,必做)

1. 安装 Jellyfin(已装可跳过)

sudo apt update
sudo apt install jellyfin

2. 安装 FFmpeg(非常关键)

Jellyfin 依赖 FFmpeg:

sudo apt install ffmpeg

查看版本:

ffmpeg -version

⚠️ Ubuntu 自带 ffmpeg 通常可用
若你用的是第三方源(如 jellyfin 官方 ffmpeg),也行


3. Jellyfin 中启用转码

浏览器登录 Jellyfin → 控制台(Dashboard)

控制台 → 播放 → 转码

勾选:

  • ✅ 允许视频转码
  • ✅ 允许音频转码
  • ✅ 允许转码到 H264

设置 转码临时目录(建议):

/var/lib/jellyfin/transcodes

确保目录存在:

sudo mkdir -p /var/lib/jellyfin/transcodes
sudo chown -R jellyfin:jellyfin /var/lib/jellyfin/transcodes

二、硬件加速转码(推荐)

方案 1:Intel 核显(最常见)

安装驱动

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

测试:

vainfo

看到 VAProfileH264 等说明正常

Jellyfin 设置

控制台 → 播放 → 硬件加速

选择:

  • VAAPI
  • 设备:/dev/dri/renderD128

加入用户组:

sudo usermod -aG render jellyfin
sudo usermod -aG video jellyfin

重启:

sudo systemctl restart jellyfin

方案 2:NVIDIA 显卡

安装驱动 + CUDA

sudo apt install nvidia-driver-535
sudo reboot
nvidia-smi

Jellyfin 中选择:

  • NVIDIA NVENC

方案 3:AMD

sudo apt install mesa-va-drivers

Jellyfin 选 VAAPI


三、常见转码失败原因

1. 权限问题(最常见)

ls -l /dev/dri

应看到:

crw-rw---- 1 root render 226, 0 renderD128

修复:

sudo usermod -aG render jellyfin
sudo reboot

2. 转码卡死 / 无画面

检查日志:

sudo journalctl -u jellyfin -f

或:

控制台 → 日志

3. Docker 用户特别注意

如果你用 Docker:

devices:
  - /dev/dri:/dev/dri

并加:

--group-add=render

四、验证是否转码成功

播放视频时:

  • 原始:4K HEVC
  • 播放端:1080p H264

在 Jellyfin 播放信息中看到:

Transcoding (H264)

✅ 成功


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

  • Ubuntu 版本
  • 是否 Docker
  • CPU / 显卡型号

我可以给你精确的一条龙配置命令。

0 踩