Ubuntu系统下Jellyfin故障排查

以下是Ubuntu系统下Jellyfin的故障排查步骤：

1. 检查服务状态

   sudo systemctl status jellyfin  # 查看服务是否运行  
   sudo journalctl -u jellyfin.service  # 查看系统日志  
   

2. 查看日志文件

   • 日志路径：/var/log/jellyfin/jellyfin.log

   sudo tail -f /var/log/jellyfin/jellyfin.log  # 实时查看日志  
   

3. 验证安装与依赖

   sudo apt update && sudo apt install jellyfin  # 重新安装  
   sudo apt install -y libicu fontconfig ffmpeg  # 安装依赖  
   

4. 排查端口与配置

   • 检查端口占用：sudo netstat -tuln | grep 8096（默认端口8096）
   • 修改配置文件：/etc/jellyfin/config.xml（确认端口、媒体库路径正确）

5. 硬件加速问题（NVIDIA显卡）

   sudo apt install nvidia-driver nvidia-container-toolkit  # 安装驱动与工具包  
   sudo reboot  # 重启后检查硬件加速是否启用  
   

6. 字体渲染问题

   • 安装中文字体：

     sudo apt install fonts-noto-cjk-extra  # 或手动上传字体至Jellyfin配置目录的font文件夹  
     

   • 在Jellyfin设置中指定字体路径。

7. 权限与网络问题

   • 确保Jellyfin用户有权访问媒体文件：

     sudo chown -R jellyfin:jellyfin /path/to/media  
     

   • 检查防火墙规则：sudo ufw allow 8096（开放端口）。

8. 其他常见问题

   • 媒体兼容性错误：在Jellyfin中将媒体类别改为“混合内容”。
   • Docker部署问题：检查容器日志 docker logs <容器ID>，确保挂载路径正确。

若以上步骤无法解决，建议参考Jellyfin官方文档或社区论坛获取进一步支持。