Ubuntu上Jellyfin日志查看与分析指南
Jellyfin在Ubuntu上的日志文件默认集中存储在/var/log/jellyfin/目录下，常见文件包括：
jellyfin.log：主日志文件，记录服务运行、媒体处理、用户访问等综合信息；access.log：访问日志，记录客户端请求详情（如IP、请求时间、资源路径）；error.log：错误日志，专门记录服务运行中的错误信息（如启动失败、媒体加载失败）。tail -f命令实时跟踪日志更新，适合监控服务运行状态（如启动过程、实时错误）。sudo tail -f /var/log/jellyfin/jellyfin.log（需root权限读取系统日志）。tail -n命令快速查看日志末尾内容，适合定位近期问题（如最后一次启动失败的原因）。sudo tail -n 100 /var/log/jellyfin/jellyfin.log（显示最后100行）。less命令分页浏览日志，支持上下翻页（空格/b）和关键词搜索（/关键词，如/error）。sudo less /var/log/jellyfin/jellyfin.log。grep命令过滤日志中的特定内容（如错误信息、客户端IP），快速定位问题。sudo tail -f /var/log/jellyfin/jellyfin.log | grep "error"（实时显示包含“error”的行）。若Jellyfin以systemd服务运行（默认方式），可使用journalctl命令查看服务关联的日志，支持按时间、服务名过滤：
sudo journalctl -u jellyfin.service；sudo journalctl -u jellyfin.service -f；sudo journalctl -u jellyfin.service --since "1 hour ago"。若通过Docker Compose运行Jellyfin，可使用以下命令查看容器日志：
docker-compose logs -f（需在Docker Compose文件所在目录执行）；jellyfin）：docker logs -f jellyfin。若Jellyfin无法启动，优先查看jellyfin.log或journalctl日志，常见原因包括：
jellyfin.log中是否有“Transcoding failed”“Codec not supported”等关键词，可能需调整转码设置或安装缺失的编解码器；jellyfin.log中是否有“Failed to scrape metadata”“API request failed”等关键词，可能需检查网络连接、TMDB API密钥或刮削站设置；access.log中是否有客户端IP的“404 Not Found”“500 Internal Server Error”等响应，可能需检查网络配置或客户端设置。为避免日志文件过大占用磁盘空间，Ubuntu预装了logrotate工具，可自动轮转、压缩日志。检查配置：
cat /etc/logrotate.d/jellyfin（默认配置通常包含daily（每日轮转）、rotate 7（保留7天）、compress（压缩旧日志）等参数）；sudo logrotate -f /etc/logrotate.d/jellyfin（立即执行轮转）。sudo获取root权限，避免权限不足导致无法读取；find命令全局搜索：sudo find / -name "jellyfin.log" 2>/dev/null；logrotate或手动删除），保持磁盘空间充足。
