Ubuntu上Jellyfin的日志如何查看

Ubuntu上查看Jellyfin日志的常用方法

1. 通過journalctl命令查看systemd日志（推薦）

若Jellyfin以systemd服務運行（Ubuntu默認方式），可使用journalctl命令查看實時或歷史日志。該命令無需直接訪問日志文件，且支持按時間、關鍵詞過濾，適合快速排查問題。

• 查看所有Jellyfin相關日志：

  journalctl -u jellyfin.service
  

• 實時查看最新日志（類似“tail -f”）：

  journalctl -u jellyfin.service -f
  

• 過濾錯誤日志（快速定位問題）：

  journalctl -u jellyfin.service | grep -i "error\|fail"
  

  注：-u指定服務名，-f表示實時跟蹤，grep用于過濾關鍵詞（如“error”“fail”）。

2. 直接查看日志文件（適用于手動分析）

Jellyfin的日志文件默認存儲在/var/log/jellyfin/目錄下，包含主日志、訪問日志、錯誤日志等，可通過文本工具查看。

• 查看主日志文件（包含核心運行信息）：

  less /var/log/jellyfin/jellyfin.log
  

  按/鍵可搜索關鍵詞（如“error”），按q退出。
• 查看訪問日志（記錄客戶端請求）：

  tail -n 50 /var/log/jellyfin/access.log
  

• 查看錯誤日志（僅顯示錯誤信息，便于快速定位問題）：

  cat /var/log/jellyfin/error.log
  

  注：若目錄不存在，可能是日志路徑未配置或Jellyfin未正常運行，可通過ls /var/log/確認。

3. Docker環境下的日志查看（若通過Docker部署）

若Jellyfin通過Docker容器運行，需使用Docker命令查看容器內日志。

• 查看容器實時日志：

  docker logs -f <container_id>
  

  其中<container_id>為Jellyfin容器的ID，可通過docker ps獲取。
• 進入容器查看日志文件：

  docker exec -it <container_id> /bin/bash
  cd /config/logs  # 進入容器內日志目錄
  ls                # 查看日志文件
  cat jellyfin.log  # 查看主日志
  

  注：Docker容器的日志默認存儲在容器內的/config/logs目錄（需確認鏡像配置）。

4. 日志輪轉與管理（避免日志過大）

Ubuntu的logrotate工具會自動輪轉Jellyfin日志（壓縮舊日志、刪除過期日志），可通過以下命令檢查或手動觸發：

• 檢查logrotate配置（確認Jellyfin日志輪轉規則）：

  sudo logrotate -d /etc/logrotate.conf
  

• 手動強制輪轉（立即壓縮當前日志）：

  sudo logrotate -f /etc/logrotate.conf
  

  注：輪轉后的日志默認存儲在/var/log/jellyfin/目錄下，文件名帶.gz后綴（如jellyfin.log.1.gz）。

注意事項

• 若日志文件無讀取權限，需使用sudo提升權限（如sudo less /var/log/jellyfin/jellyfin.log）。
• 若日志路徑與默認不符，可檢查Jellyfin配置文件（/etc/jellyfin/jellyfin.conf）中的LogFile參數，確認自定義路徑。