centos下jellyfin的故障排查步驟

CentOS下Jellyfin故障排查步驟

1. 檢查Jellyfin服務狀態

首先確認Jellyfin服務是否正在運行，使用以下命令查看服務狀態：

systemctl status jellyfin

若服務未運行（顯示“inactive”或“failed”），嘗試啟動服務：

systemctl start jellyfin

若啟動失敗，需結合日志進一步分析（參考步驟2）。

2. 查看Jellyfin日志文件

日志是定位故障的核心工具，Jellyfin的日志默認存儲在/var/log/jellyfin/目錄下（主要文件為jellyfin.log）?？墒褂靡韵旅顚崟r查看最新日志：

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進行媒體轉碼，若未安裝或版本過低，會導致轉碼失?。ㄈ纭癟ranscoding 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”）?？蓢L試：

• 進入Jellyfin Web界面的“插件”頁面，禁用最近安裝的插件；
• 若問題消失，聯系插件開發者獲取兼容版本。

9. 重新啟動Jellyfin服務

在完成上述排查（如修改配置、安裝依賴、調整權限）后，重啟Jellyfin服務使更改生效：

systemctl restart jellyfin

重啟后再次檢查服務狀態和日志，確認問題是否解決。