centos jellyfin怎么排错

在 CentOS 上排查 Jellyfin 问题，可以按下面步骤从“看得见的地方”到“系统级”逐步排错。

一、先看 Jellyfin 服务状态

systemctl status jellyfin

重点看：

• active (running) 还是 failed
• 有没有红色报错

如果失败：

journalctl -u jellyfin -xe

这是 最重要的一步，大部分问题都在这里。

二、查看 Jellyfin 日志

1️⃣ systemd 日志

journalctl -u jellyfin --no-pager -n 200

2️⃣ Jellyfin 自身日志

默认路径：

/var/log/jellyfin/

常用：

cat /var/log/jellyfin/jellyfin.log

或实时看：

tail -f /var/log/jellyfin/jellyfin.log

三、Web 无法访问（最常见）

检查端口

默认是 8096

ss -lntp | grep 8096

或

netstat -lntp | grep 8096

防火墙（CentOS 常见坑）

firewall-cmd --list-all

放行端口：

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

SELinux（非常常见）

临时测试：

setenforce 0

如果这样能访问，说明是 SELinux 问题。

永久解决（示例）：

setsebool -P httpd_can_network_connect 1

四、媒体库扫描不到 / 没权限

目录权限

Jellyfin 默认用户是 jellyfin

ps aux | grep jellyfin

给目录权限：

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

挂载盘问题

如果是 NTFS / 外接硬盘：

mount | grep 你的盘

确保挂载参数有 uid/gid 或权限正确。

五、突然启动不了（升级后常见）

1️⃣ 看详细错误

journalctl -u jellyfin -xe

2️⃣ 回滚版本（如有）

dnf history
dnf history undo 序号

3️⃣ 配置文件损坏

备份后重命名：

mv /etc/jellyfin /etc/jellyfin.bak

再启动（会重新初始化）。

六、转码 / 播放失败

检查 ffmpeg

which ffmpeg
ffmpeg -version

Jellyfin 设置 → 播放 → 转码：

• 路径填 /usr/bin/ffmpeg

硬件转码（CentOS 特别注意）

• 需要 intel-media-driver / nvidia
• 用户要在 video 组：

usermod -aG video jellyfin

七、快速自检清单 ✅

• [ ] systemctl status jellyfin
• [ ] journalctl -u jellyfin -xe
• [ ] 端口 8096 通不通
• [ ] 防火墙 / SELinux
• [ ] 目录权限
• [ ] ffmpeg 是否存在

如果你愿意，可以把下面信息贴出来，我可以直接帮你定位：

1. systemctl status jellyfin 输出
2. journalctl -u jellyfin -xe 报错
3. 是 装不上 / 起不来 / 访问不了 / 扫描不到

我可以按你的具体报错一步步带你修。