Ubuntu上Jellyfin的日志查看

Ubuntu 上 Jellyfin 日志查看指南

一 常用查看方式

• 使用 systemd 查看服务日志：查看全部输出为 journalctl -u jellyfin.service；实时跟踪为 journalctl -u jellyfin.service -f；按时间筛选如 –since “2025-12-30 00:00:00” --until “2025-12-30 23:59:59”；只看错误级别为 -p err。这些命令适合定位启动失败、崩溃、权限异常等系统层面的问题。
• 直接查看应用日志文件：Jellyfin 的日志通常位于 /var/log/jellyfin/，常用命令有 tail -n 50 /var/log/jellyfin/jellyfin.log（查看最近 50 行）和 tail -f /var/log/jellyfin/jellyfin.log（实时跟踪）。当 systemd 日志信息不足或需要更细的访问/转码日志时，直接看应用日志更有效。
• 查看系统全局日志：当怀疑网络、权限或内核问题时，可查看 /var/log/syslog（如 tail -n 50 /var/log/syslog 或 tail -f /var/log/syslog）。系统日志能补充服务日志未覆盖的上下文信息。

二 Docker 部署的查看方式

• 使用 docker logs 查看容器日志：基本用法 docker logs <container_id>；实时跟踪 docker logs -f <container_id>；查看最近 N 行 docker logs --tail 200 <container_id>。若日志量很大，可结合 grep 过滤关键字（如 docker logs | grep -i “error”）。

三 快速排查命令清单

• 服务状态与启动：用 sudo systemctl status jellyfin 检查运行状态与最近报错；必要时 sudo systemctl restart jellyfin 使配置生效。
• 日志定位：实时看服务日志 journalctl -u jellyfin.service -f；看应用日志 tail -f /var/log/jellyfin/jellyfin.log；看系统日志 tail -f /var/log/syslog。
• 网络连通性：刮削或插件需要外网时，测试 ping api.themoviedb.org；若不通，检查 DNS 与防火墙规则（如 sudo ufw status、sudo ufw allow 8096/tcp）。

四 日志路径与常见位置