Ubuntu系统下Jellyfin的故障排查

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

1. 查看日志
   • 系统日志：sudo journalctl -xe
   • Jellyfin日志：sudo tail -f /var/log/jellyfin/jellyfin.log（若使用Docker，需进入容器查看对应日志）
2. 检查服务状态
   • sudo systemctl status jellyfin：确认服务是否运行。
   • 若未运行，尝试启动：sudo systemctl start jellyfin。
3. 端口与防火墙
   • 检查默认端口（8096）是否被占用：sudo netstat -tuln | grep 8096。
   • 若占用，修改配置文件/etc/jellyfin/config.xml中的端口，或调整防火墙规则：sudo ufw allow 端口号。
4. 依赖与安装问题
   • 确保依赖项完整：sudo apt update && sudo apt install jellyfin。
   • 若使用Docker，检查镜像是否正确拉取：docker pull jellyfin/jellyfin。
5. 硬件加速与字体问题
   • NVIDIA显卡硬解：安装驱动及容器工具包，确保配置正确。
   • 字体渲染异常（如方块字）：安装中文字体（如fonts-noto-cjk-extra），并重启服务。
6. 配置与权限
   • 检查配置文件/etc/jellyfin/config.xml的端口、媒体库路径等设置。
   • 确保媒体文件权限正确，Jellyfin用户可访问。
7. 其他常见问题
   • 播放兼容性问题：尝试将媒体类别改为“混合内容”。
   • 缓存异常：删除缓存文件（路径参考日志或配置文件），重新扫描媒体库。

若以上步骤无法解决，建议查阅Jellyfin官方文档或社区论坛获取针对性帮助。