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参数，确认自定义路径。