Ubuntu上提升Jellyfin稳定性的实用清单
一 系统与基础环境
- 保持系统与软件为最新稳定版，及时修补漏洞与兼容性问题；精简不必要的组件，降低资源争用与故障面。
- 使用官方仓库安装或升级 Jellyfin，避免依赖冲突；APT 安装示例：导入 GPG 密钥、添加源、安装与启动服务。
- 媒体存储建议使用 NFS 挂载 NAS 目录，减少本地磁盘抖动对播放的影响。
- 启用 UFW 防火墙并仅放行必要端口（如 8096/TCP），降低被滥用风险。
- 部署方式优先选择 APT 或 Docker；Docker 场景需正确映射视频设备以启用硬件加速。
二 硬件加速与解码
- 优先启用硬件解码以显著降低 CPU 占用、减少卡顿与崩溃概率，尤其是 4K/HDR 场景。
- Intel 核显：安装驱动包 intel-media-va-driver-non-free，在 Jellyfin 中启用 VAAPI；支持的处理器建议开启 GuC/HuC 固件以提升转码效率与稳定性。
- NVIDIA 显卡：安装专有驱动，并在 Jellyfin 中启用 NVDEC/NVENC；按需使用 nvidia-smi 监控 GPU 温度与负载。
- 验证硬件加速是否生效：播放高码率片源，观察 CPU 占用是否显著下降、是否出现解码错误；必要时回退到软件解码排查。
三 Jellyfin服务与资源配置
- 通过 systemd 调整服务的内存与资源限制，避免因内存不足导致进程被 OOM Killer 终止。
- 适度启用并配置缓存，减少磁盘抖动；根据设备与并发量限制并发会话数，防止过载。
- 在“播放”设置中优先选择 Direct Play/原画，仅对不兼容的客户端启用转码，降低转码链路的不确定性与故障点。
- 选择高效的视频编码（如 H.264/H.265/AV1 的主流编码），从源头降低码率与解码压力。
- 定期更新 Jellyfin 与 ffmpeg-jellyfin，获取最新的兼容性与稳定性修复。
四 网络与存储访问
- 确保服务器可稳定访问外部元数据服务（如 TheMovieDb/TheTVDB），避免刮削失败引发库刷新异常。
- 对外访问建议使用 Nginx/Apache 反向代理并配置 HTTPS，提升连接稳定性与安全性；同时优化网络参数，减少带宽浪费与抖动。
- 使用 NFS 挂载远端媒体库时，确保挂载选项与网络链路稳定；对高并发读取场景可适当调整 NFS 参数（如 rsize/wsize、并发请求数）。
五 监控 日志与故障排查
- 建立日常巡检：用 htop/nvidia-smi 观察 CPU/GPU/内存 使用；查看 /var/log/jellyfin/ 下的服务日志，关注异常堆栈与重启记录。
- 服务异常时，先检查运行状态：
- 查看状态：sudo systemctl status jellyfin
- 重启服务：sudo systemctl restart jellyfin
- 网络与权限问题排查：
- 防火墙：sudo ufw status，必要时放行 8096/TCP
- 连通性：测试到 api.themoviedb.org 的访问
- 权限：确保 Jellyfin 对数据目录与媒体目录具备正确所有权与权限（如 jellyfin:jellyfin）
- 刮削异常定位：查看日志中 MetadataService/Scraping/Failed 等关键词，必要时更换刮削器或手动关联元数据。
