Jellyfin为啥卡在CentOS

Jellyfin 在 CentOS 上“卡住”通常不是单一原因，而是 系统环境、依赖、防火墙、SELinux、FFmpeg、权限 等多点叠加的结果。下面我按最常见原因 → 排查方法 → 解决方案给你系统梳理一遍。

一、最常见的卡点（90% 都在这）

1️⃣ CentOS 版本太老（最常见）

很多人在 CentOS 7 上跑 Jellyfin，问题最多。

问题表现

• 启动卡住
• 页面打不开
• 转码直接失败
• 日志报 glibc / ffmpeg 相关错误

原因

• Jellyfin 新版本依赖 glibc ≥ 2.28
• CentOS 7 的 glibc 是 2.17

✅ 解决方案

• ✅ 推荐：换系统
  • Rocky Linux 8 / 9
  • AlmaLinux 8 / 9
  • Debian 11 / 12
• ❌ 不推荐硬在 CentOS 7 上折腾

2️⃣ 防火墙没放行端口

默认端口

• HTTP：8096
• HTTPS：8920

现象

• 本地能访问
• 局域网 / 外网访问卡住或超时

✅ 检查 & 放行

firewall-cmd --list-ports
firewall-cmd --add-port=8096/tcp --permanent
firewall-cmd --reload

3️⃣ SELinux 拦截（CentOS 专属坑）

现象

• 服务启动了
• 访问直接 403 / 空白 / 卡死

✅ 快速验证

getenforce

如果是 Enforcing：

setenforce 0

✅ 永久关闭（不推荐生产）

sed -i 's/^SELINUX=.*/SELINUX=disabled/' /etc/selinux/config

✅ 正确做法（推荐） 给 Jellyfin 放行 SELinux：

setsebool -P httpd_can_network_connect 1

4️⃣ FFmpeg / 转码卡死

表现

• 播放视频直接转圈
• Docker 里卡住
• CPU 100%，但画面不动

✅ 排查

journalctl -u jellyfin -f

✅ 常见解决

• 确认系统 FFmpeg 版本兼容
• 或指定 Jellyfin 自己的 ffmpeg：

Dashboard → Playback → FFmpeg path
/usr/lib/jellyfin-ffmpeg/ffmpeg

5️⃣ 权限问题（媒体目录访问不了）

现象

• 扫描不到媒体
• 播放失败
• 日志报 Permission denied

✅ 解决

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

或者把 jellyfin 加入用户组：

usermod -aG youruser jellyfin

二、Docker 方式在 CentOS 上卡？

如果是 Docker：

常见问题

1. SELinux + Docker
2. volume 挂载权限
3. firewalld 没放行

✅ 推荐 Docker 启动方式

docker run -d \
  --name jellyfin \
  -p 8096:8096 \
  -v /media:/media \
  -v /jellyfin/config:/config \
  --restart=unless-stopped \
  jellyfin/jellyfin

三、快速定位问题（必做）

执行下面几个命令，基本能定位 80% 的问题：

systemctl status jellyfin
journalctl -u jellyfin -n 50
ss -lntp | grep 8096

四、我可以直接帮你定位（最快）

你可以直接贴我：

1. CentOS 版本

cat /etc/os-release

2. Jellyfin 安装方式

• rpm？
• docker？
• 手动？

3. 报错日志

journalctl -u jellyfin -n 50

4. 具体卡在哪一步

• 安装？
• 启动？
• 播放？
• 扫码媒体？

我可以直接给你一套针对你环境的修复方案，比你自己试要快很多。