ubuntu jellyfin为何无法播放

Ubuntu 上 Jellyfin 无法播放的原因有很多，下面按最常见 → 较少见的顺序帮你排查。你可以对照看看是哪一种情况。

一、最常见原因

1️⃣ 浏览器不支持视频编码（尤其是 HEVC / 10bit）

Jellyfin 网页端依赖浏览器解码：

✅ H.264：基本都支持
❌ HEVC / H.265 / 10bit：
- Firefox：不支持
- Chrome（Linux）：通常不支持
- Edge（Linux）：部分支持

表现

点播放后一直转圈
提示 “此客户端不支持该媒体”

解决办法

使用 Jellyfin Media Player（桌面客户端）

flatpak install flathub com.jellyfin.JellyfinMediaPlayer

或在服务器端开启 转码（Transcoding）

2️⃣ 没有开启硬件 / 软件转码

如果视频格式浏览器不支持，必须靠 Jellyfin 转码。

检查方法

后台 → 控制台 → 播放 → 转码
勾选：
- Enable H.264
- Enable HEVC（如有显卡）
用户 → 播放设置 → 允许转码

Ubuntu 软件转码依赖

sudo apt install ffmpeg

Jellyfin 自带 ffmpeg 一般没问题，但系统 ffmpeg 缺失也会失败。

3️⃣ 权限问题（库目录无法读取）

Jellyfin 运行用户通常是 jellyfin

sudo -u jellyfin ls /你的媒体目录

如果报错：

sudo chown -R jellyfin:jellyfin /媒体目录
sudo chmod -R 755 /媒体目录

或用组：

sudo usermod -aG youruser jellyfin

二、中等常见问题

4️⃣ 防火墙 / 端口问题

默认端口：8096
本机访问：http://localhost:8096
局域网访问需放行：

sudo ufw allow 8096

5️⃣ 视频文件本身损坏

测试：

ffprobe 视频文件.mkv

或换一个 MP4（H.264）测试是否能播。

6️⃣ 客户端不是 Jellyfin 官方 App

某些“第三方客户端”不支持转码
推荐：
- Jellyfin Web
- Jellyfin Media Player
- 官方 Android / iOS App

三、高级问题（较少见）

7️⃣ 显卡驱动 / 硬件加速失败

如果你开了 VA-API / NVENC：

Intel：需 intel-media-va-driver
NVIDIA：需 nvidia-driver + ffmpeg 支持

查看：

vainfo

8️⃣ AppArmor / SELinux 限制

Ubuntu 默认 AppArmor 可能限制 Jellyfin 读盘。

检查：

sudo aa-status | grep jellyfin

四、快速自检清单 ✅

你可以按顺序试：

换 MP4 + H.264 视频
用 Jellyfin Media Player
确认能 ls 媒体目录
确认转码已开启
看日志：
```
sudo journalctl -u jellyfin -f
```

如果你愿意，可以告诉我：

Ubuntu 版本
Jellyfin 安装方式（apt / docker / flatpak）
视频格式（mkv? hevc?）
用什么客户端播放

我可以给你更精确的解决方案。