总体结论
在CentOS 7/8 等版本上，Jellyfin 的兼容性总体良好，支持 RPM 包 与 Docker 两种主流部署方式；常见兼容性问题主要集中在依赖缺失、端口与防火墙、权限/SELinux、插件版本、硬件加速等环节。通过规范化依赖与网络配置、合理的权限策略与日志定位，绝大多数问题都能稳定解决。
常见兼容性问题与对策
- 依赖与多媒体工具
- 现象：启动失败、转码不可用、界面异常。
- 处理：安装基础依赖（如 libicu、fontconfig），并通过 EPEL/RPM Fusion 配置或直接使用官方仓库安装 FFmpeg，避免“缺编解码器/转码失败”。
- 端口与防火墙
- 现象：本机能访问 8096，外网访问失败。
- 处理：放行 8096（HTTP） 与 8920（HTTPS） 端口（firewalld/iptables），或临时停火墙验证问题所在。
- 权限与 SELinux
- 现象：媒体库扫描失败、日志报权限拒绝。
- 处理：确保 Jellyfin 运行用户对配置、缓存、日志与媒体目录具备读写权限；必要时为 Jellyfin 配置合适的 SELinux 布尔值/策略 或设置为宽容模式做排查。
- 插件与版本匹配
- 现象：插件冲突、功能异常、CPU 占用飙升。
- 处理：保持插件与服务器版本匹配与更新；出现异常先禁用第三方插件验证。
- 存储与挂载
- 现象：S3/对象存储或网络盘挂载后媒体不可读。
- 处理：使用 s3fs-fuse 挂载对象存储时，正确配置密钥与访问端点，确保挂载点权限与 Jellyfin 运行用户一致。
- 硬件加速与转码
- 现象：播放卡顿、转码失败、核显未被调用。
- 处理：确认内核与驱动加载（如 i915 模块）、VA-API 状态与权限；在设置中启用硬件加速并验证转码路径。
版本与安装方式建议
- 系统版本：优先选择 CentOS 7/8 的 x86_64 环境，保持系统与安全补丁为较新稳定版本。
- 安装方式：
- RPM 包：便于与系统深度集成、可用 systemd 管理；注意依赖与仓库配置。
- Docker：环境隔离、迁移方便；在 CentOS 上建议使用 10.6+ 版本镜像以获得更好的平台适配。
- 版本选择：避免过旧版本，及时更新以修复已知漏洞与兼容性问题（如历史 CVE 修复）。
快速排查清单
- 服务与端口：确认服务已启动（systemctl status jellyfin），端口 8096/8920 处于监听（ss -ltnp | grep 8096），防火墙已放行。
- 依赖与转码：ffmpeg -version 可用，/usr/bin/ffmpeg 可执行，Jellyfin 设置中 FFmpeg 路径正确。
- 权限与 SELinux：媒体目录属主/属组与 Jellyfin 运行用户一致；必要时 setenforce 0 验证 SELinux 影响。
- 日志定位：查看 /var/log/jellyfin/ 下的服务与日志文件，按报错关键词（权限、编解码、路径）定位模块。
- 插件与客户端：先禁用所有第三方插件，用官方客户端或 Web 验证；再逐个恢复定位问题插件。