centos jellyfin为何黑屏

在 CentOS 上运行 Jellyfin 出现黑屏，通常不是 Jellyfin 本身坏了，而是播放/显示/解码环境有问题。下面按常见原因 → 排查方法 → 解决办法给你梳理。

一、最常见原因（90% 情况）

1️⃣ 浏览器硬件加速 / 解码失败（最常见）

现象：

能进入 Jellyfin 页面
点开视频后 黑屏、无声音、一直转圈

✅ 解决：

浏览器关闭硬件加速
Chrome / Edge：
设置 → 系统 → 关闭“使用硬件加速”
尝试：
- Firefox
- 客户端（Jellyfin Media Player）

2️⃣ 视频需要转码，但 CentOS 没有解码器

现象：

某些视频黑屏
日志里出现 ffmpeg failed

✅ 解决（CentOS）：

sudo yum install ffmpeg

或启用 RPM Fusion：

sudo yum install epel-release
sudo yum localinstall --nogpgcheck https://download1.rpmfusion.org/free/el/rpmfusion-free-release-$(rpm -E %rhel).noarch.rpm
sudo yum install ffmpeg ffmpeg-devel

3️⃣ Jellyfin 转码目录无权限

现象：

黑屏
日志提示 Permission denied

✅ 解决：

sudo chown -R jellyfin:jellyfin /var/lib/jellyfin
sudo chmod -R 755 /var/lib/jellyfin

二、服务器 / 显卡相关问题

4️⃣ 使用 Intel / NVIDIA 硬解但未配置

现象：

4K 视频必黑屏
CPU 飙高但无画面

✅ 检查：

vainfo
nvidia-smi

✅ Jellyfin 设置：

控制台 → 播放 → 转码
勾选对应硬件解码（VAAPI / NVENC）

⚠️ CentOS 默认 不支持消费级 NVIDIA 驱动，需手动装驱动

5️⃣ SELinux 阻止访问

现象：

页面正常
播放黑屏

✅ 临时测试：

sudo setenforce 0

✅ 永久解决（谨慎）：

sudo sed -i 's/SELINUX=enforcing/SELINUX=permissive/' /etc/selinux/config

三、网络 / 客户端问题

6️⃣ 反向代理配置错误（Nginx）

现象：

局域网正常
外网黑屏

✅ Nginx 必须包含：

proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;

四、快速自查清单 ✅

你可以按顺序试：

换浏览器（Firefox）
关硬件加速
看日志：
```
sudo journalctl -u jellyfin -f
```
确认 ffmpeg 可用
确认不是 4K/HDR 直出问题

五、如果你愿意，我可以进一步帮你

你可以告诉我：

CentOS 版本（7 / 8 / Stream）
是否用 Docker
黑屏是 网页黑屏 还是 客户端黑屏
视频格式（HEVC？4K？）

我可以给你精准的一步到位方案。