centos下jellyfin的故障排查步骤

CentOS下Jellyfin故障排查步骤

1. 检查Jellyfin服务状态

首先确认Jellyfin服务是否正在运行，使用以下命令查看服务状态：

systemctl status jellyfin

若服务未运行（显示“inactive”或“failed”），尝试启动服务：

systemctl start jellyfin

若启动失败，需结合日志进一步分析（参考步骤2）。

2. 查看Jellyfin日志文件

日志是定位故障的核心工具，Jellyfin的日志默认存储在/var/log/jellyfin/目录下（主要文件为jellyfin.log）。可使用以下命令实时查看最新日志：

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

或使用journalctl查看systemd管理的日志（更全面）：

journalctl -u jellyfin -f

通过日志中的错误关键词（如“Permission denied”“Port already in use”“FFmpeg not found”）可快速定位问题根源。

3. 验证系统资源是否充足

Jellyfin运行需要足够的CPU、内存和磁盘空间。使用以下命令检查资源使用情况：

CPU和内存：top（按M排序内存占用）或htop（更直观）；
磁盘空间：df -h（查看根分区及媒体库所在分区剩余空间）；
磁盘I/O：iotop（检查是否有进程大量占用磁盘）。
若资源不足（如内存剩余<1GB、磁盘空间<10%），需优化配置（如降低转码质量）或升级服务器。

4. 检查网络与端口配置

网络连通性：使用ping命令测试服务器与客户端之间的网络连通性（如ping 192.168.1.100）；
端口占用：Jellyfin默认使用8096（HTTP）、8920（HTTPS）、1900（DLNA）、5353（Bonjour）端口，使用以下命令检查端口是否被占用：
```
netstat -tuln | grep -E '8096|8920|1900|5353'
```
若端口被占用，可修改Jellyfin配置文件（/etc/jellyfin/config.xml或/config/system.xml）中的端口设置，或停止占用端口的服务；

防火墙设置：CentOS的防火墙（firewalld）需开放Jellyfin端口，命令如下：

firewall-cmd --zone=public --add-port=8096/tcp --permanent
firewall-cmd --zone=public --add-port=8920/tcp --permanent
firewall-cmd --zone=public --add-port=1900/udp --permanent
firewall-cmd --zone=public --add-port=5353/udp --permanent
firewall-cmd --reload

若使用ufw（Ubuntu常用），可替换为ufw allow 8096/tcp。

5. 确认依赖包与FFmpeg安装

Jellyfin依赖ffmpeg进行媒体转码，若未安装或版本过低，会导致转码失败（如“Transcoding failed”）。需安装以下依赖：

yum install -y libicu fontconfig ffmpeg

若未配置rpmfusion源，需先添加（以CentOS 7为例）：

yum install epel-release
wget https://download1.rpmfusion.org/free/el/rpmfusion-free-release-7.noarch.rpm
rpm -ivh rpmfusion-free-release-7.noarch.rpm

再安装ffmpeg：

yum install ffmpeg

安装后，可通过ffmpeg -version验证是否安装成功。

6. 检查配置文件正确性

Jellyfin的主配置文件通常位于/etc/jellyfin/jellyfin.conf（或/config/config.xml），需检查以下关键配置：

媒体库路径：确保<Library>标签中的路径存在且Jellyfin用户（默认jellyfin）有读取权限；
端口设置：确认<Port>标签中的端口未被占用且与防火墙设置一致；
数据库连接：若使用外部数据库（如MySQL），检查<Database>标签中的连接字符串（用户名、密码、主机）是否正确；
FFmpeg路径：确认<FFmpegPath>标签中的路径（如/usr/bin/ffmpeg）存在。

7. 验证文件与目录权限

Jellyfin运行的用户（默认jellyfin）需对以下目录有读写权限：

配置目录：/etc/jellyfin/（或/config/）；
媒体库目录：用户添加的媒体文件所在目录（如/mnt/media/Movies）；
日志目录：/var/log/jellyfin/。
若权限不足，可使用以下命令修改（以媒体库目录为例）：

chown -R jellyfin:jellyfin /mnt/media/Movies
chmod -R 755 /mnt/media/Movies

注意：避免将媒体库目录设置为root所有，否则可能导致Jellyfin无法访问。

8. 处理插件兼容性问题

若最近安装或更新了插件，可能因版本不兼容导致故障（如“Plugin not loaded”）。可尝试：

进入Jellyfin Web界面的“插件”页面，禁用最近安装的插件；
若问题消失，联系插件开发者获取兼容版本。

9. 重新启动Jellyfin服务

在完成上述排查（如修改配置、安装依赖、调整权限）后，重启Jellyfin服务使更改生效：

systemctl restart jellyfin

重启后再次检查服务状态和日志，确认问题是否解决。