Ubuntu 上提升 Jellyfin 播放速度的可行方案
一 硬件加速优先启用
- 在 Intel 平台安装并启用 Intel Quick Sync Video（QSV） 或 VAAPI，可显著降低 CPU 占用，提升 4K/H.265/AV1 解码流畅度。
- 在 NVIDIA 平台安装专有驱动与 nvidia-container-toolkit，并在容器中将 /dev/dri 与 GPU 设备映射给 Jellyfin。
- 在 AMD 平台安装 Mesa/VA-API 驱动，并在 Jellyfin 中启用 VAAPI。
- 在 Jellyfin Web 管理端进入 控制台 → 播放 → 转码，选择对应的 硬件加速 选项，并勾选可用的 硬件解码 项。
- 注意：在 Intel 平台上通常 QSV 的性能优于 VAAPI。
二 Docker 部署的 GPU 直通与权限
- 宿主机安装好驱动后，在 Docker Compose 中映射设备并启用 GPU：
- Intel/AMD：挂载 /dev/dri（示例：volumes: - /dev/dri:/dev/dri）。
- NVIDIA：使用 –gpus all 并配置 nvidia-container-toolkit。
- 示例（Docker Compose，仅示意关键项）：
- Intel/AMD：
- volumes: - /dev/dri:/dev/dri
- 可选：devices: - /dev/dri:/dev/dri
- NVIDIA：
- deploy: resources: reservations: devices: - driver: nvidia count: 1 capabilities: [gpu]
- 容器启动后，在 Jellyfin 控制台启用对应的 硬件加速 与 硬件解码。
三 播放器与网络优化
- 播放器选择：在客户端或 Web 端遇到卡顿时，可切换为 外部播放器（VLC/Kodi） 或 LibVLC，通常解码与兼容性更好。
- 编码与码率：优先使用 H.265/HEVC 或 AV1 等高效编码，减小文件体积、降低带宽占用，提升起播与拖动响应。
- 网络链路：确保服务器与客户端之间的 带宽与链路稳定，局域网尽量使用 有线千兆/2.5G 或有线直连，避免无线抖动与拥塞。
- 并发与缓存：在服务器资源有限时，适当 限制并发会话数（MaxConcurrentSessions），并 启用/调大缓存，可减少重复加载与卡顿。
四 系统与版本维护
- 保持 Jellyfin 与 ffmpeg-jellyfin 等组件为 最新版本，及时获得性能修复与兼容性提升。
- 更新 显卡驱动 与系统组件，避免因驱动过旧导致的解码失败或性能低下。
- 监控资源：使用 htop（CPU/内存）与 nvidia-smi（GPU）观察瓶颈，必要时进行 硬件升级（SSD/NVMe、内存、CPU）。
五 4K 播放与快速验证
- 确认硬件支持 4K 解码，并在 Jellyfin 中启用 硬件加速；播放 H.265/HEVC 或 AV1 的 4K 片源时，CPU 占用应明显降低、起播更快。
- 快速验证步骤：
- 在控制台开启 硬件加速 与 硬件解码；
- 播放一部 4K/H.265 影片，观察 CPU/GPU 占用与是否出现卡顿；
- 若仍卡顿，切换到 外部播放器（VLC/Kodi） 复测；
- 检查 网络带宽/链路质量 与 并发会话数。
