CentOS如何调试Jellyfin

在 CentOS 上调试 Jellyfin，一般从 日志、服务状态、权限、端口、FFmpeg、SELinux 这几个方向入手。下面按“由浅入深”的顺序给你一套实用排查方法。

一、确认 Jellyfin 是否正常运行

1️⃣ 查看服务状态

systemctl status jellyfin

常见状态：

✅ active (running)：服务正常
❌ failed / inactive：服务未启动

如果没启动：

systemctl start jellyfin
systemctl enable jellyfin

二、查看 Jellyfin 日志（最重要）

1️⃣ systemd 日志

journalctl -u jellyfin -f

适合看：

启动失败
崩溃
端口冲突

2️⃣ Jellyfin 自身日志

默认路径：

/var/log/jellyfin/

重点文件：

/var/log/jellyfin/jellyfin.log
/var/log/jellyfin/jellyfin.err.log

查看实时日志：

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

常见错误关键词：

Permission denied
FFmpeg exited with code
Address already in use
SQLite error

三、检查端口与访问问题

1️⃣ 默认端口

Jellyfin 默认使用：

8096（HTTP）
8920（HTTPS，若启用）

2️⃣ 检查端口监听

ss -lntp | grep 8096

或

netstat -lntp | grep 8096

如果没有监听：

服务没启动
端口被占用

3️⃣ 防火墙（CentOS 常见坑）

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

四、权限问题（非常常见）

1️⃣ 媒体目录权限

假设媒体目录是 /data/media：

chown -R jellyfin:jellyfin /data/media
chmod -R 755 /data/media

确认 Jellyfin 用户：

ps aux | grep jellyfin

2️⃣ SELinux（CentOS 特有）

SELinux 经常导致 能扫描但播放失败。

查看状态

getenforce

临时关闭测试

setenforce 0

如果关闭后正常，说明是 SELinux 问题。

正确做法（推荐）

semanage fcontext -a -t httpd_sys_content_t "/data/media(/.*)?"
restorecon -Rv /data/media

五、播放失败 / 转码问题（FFmpeg）

1️⃣ 查看是否安装 FFmpeg

ffmpeg -version

Jellyfin 需要 FFmpeg（通常自带或单独安装）。

2️⃣ 转码失败日志

在 jellyfin.log 中常见：

FFmpeg exited with code 1

手动测试 FFmpeg

ffmpeg -i /data/media/test.mp4 -f null -

3️⃣ 硬件转码（Intel / NVIDIA）

确认驱动
确认 /dev/dri 权限

ls -l /dev/dri
chown -R jellyfin:jellyfin /dev/dri

六、数据库 / 配置损坏

Jellyfin 使用 SQLite，数据库损坏会导致无法启动。

数据库位置：

/var/lib/jellyfin/data/

备份后尝试：

mv /var/lib/jellyfin/data/jellyfin.db /var/lib/jellyfin/data/jellyfin.db.bak
systemctl restart jellyfin

⚠️ 会丢失部分配置（用户、播放记录）

七、使用调试模式（高级）

编辑服务文件：

systemctl edit jellyfin

添加：

[Service]
Environment="JELLYFIN_LOG__LOGLEVEL=Debug"

重载并重启：

systemctl daemon-reload
systemctl restart jellyfin

八、快速排查清单（推荐顺序）

✅ systemctl status jellyfin
✅ journalctl -u jellyfin -f
✅ /var/log/jellyfin/jellyfin.log
✅ 端口 + 防火墙
✅ 媒体目录权限
✅ SELinux
✅ FFmpeg / 转码

九、如果你愿意，我可以更精确帮你

你可以直接贴出：

systemctl status jellyfin
journalctl -u jellyfin --no-pager | tail -n 50
或 jellyfin.log 报错片段

我可以 直接帮你定位是哪一类问题（启动失败 / 播放卡死 / 转码失败 / 权限）。