如何排查ubuntu上jellyfin的故障

当你在Ubuntu上使用Jellyfin媒体服务器时遇到故障，可以尝试以下几种故障排除方法：

检查Jellyfin服务状态

首先，确保Jellyfin服务正在运行。你可以使用以下命令来检查和管理Jellyfin服务：

检查Jellyfin服务状态：

sudo systemctl status jellyfin

启动Jellyfin服务：

sudo systemctl start jellyfin

停止Jellyfin服务：

sudo systemctl stop jellyfin

重启Jellyfin服务：

sudo systemctl restart jellyfin

查看Jellyfin日志

Jellyfin的日志文件通常位于 /var/log/jellyfin/ 目录下。查看日志文件可以帮助你找到具体的错误信息。例如，使用以下命令实时查看Jellyfin的日志：

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

检查依赖项

确保所有必要的依赖项都已安装。可以使用以下命令安装Jellyfin及其依赖项：

sudo apt update
sudo apt install jellyfin

检查配置文件

检查Jellyfin的配置文件 /etc/jellyfin/config.xml，确保所有设置正确。特别是检查以下部分：

端口：默认端口号为8096，确保没有被其他服务占用。
媒体库：确保媒体文件路径正确，并且Jellyfin有权限访问这些文件。
共享文件夹：确保共享文件夹已正确配置并且Jellyfin可以访问。

字体渲染问题

如果遇到字体渲染问题（例如电影字幕显示为方块乱码），可以尝试以下步骤：

安装中文字体：

sudo apt install fonts-noto-cjk-extra

重启Jellyfin服务：

sudo systemctl restart jellyfin

清除缓存：

sudo rm -rf /var/cache/jellyfin/*

重新扫描媒体库：在Jellyfin网页界面，选择设置，然后扫描媒体库。

GPU硬解问题

如果使用Nvidia显卡并且遇到硬解问题，可以尝试以下步骤：

安装Nvidia驱动和Nvidia Container Toolkit：

sudo apt install nvidia-driver
curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg
curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list
sudo apt update
sudo apt install nvidia-container-toolkit

重新安装Jellyfin容器：

docker run -d --net mybridge --name jellyfin -p 8096:8096 -v /home/ubuntu/mount0/docker/jellyfin/config:/config -v /home/ubuntu/mount0/docker/jellyfin/cache:/cache -v /home/ubuntu/mount0:/media --restartunless-stopped --gpus all jellyfin/jellyfin

兼容性问题

如果遇到“该客户端与媒体不兼容，服务器未发送兼容的媒体格式”的错误，可以尝试以下步骤：

检查媒体类别：在Jellyfin管理页面，将媒体的类别从“电视节目”改为“混合内容”。
更新FFmpeg：确保FFmpeg已正确安装并且是最新版本。可以从Jellyfin的官方文档或GitHub页面获取安装指南。