如何排查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

檢查依賴項

確保所有必要的依賴項都已安裝?？梢允褂靡韵旅畎惭bJellyfin及其依賴項：

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已正確安裝并且是最新版本?？梢詮腏ellyfin的官方文檔或GitHub頁面獲取安裝指南。