Ubuntu 上提升 Jellyfin 视频质量的实用方案
一 硬件加速与驱动
- 优先启用硬件解码/编码，显著降低 CPU 占用并提升画质稳定性。
- Intel 平台：安装驱动与工具后启用 Quick Sync（QSV），通常较 VAAPI 性能更好，且 HDR 色调映射更易配置。
- 安装：
sudo apt install intel-media-va-driver-non-free vainfo
- 验证：
vainfo 应看到 iHD 驱动与一长串支持的解码/编码格式。
- Jellyfin 后台：播放 > 转码，选择 硬件加速：VAAPI，设备填 /dev/dri/renderD128；若使用 QSV，选择 Quick Sync 并开启色调映射。
- NVIDIA 平台：安装专有驱动与 nvidia-container-toolkit（Docker 场景），Jellyfin 选择 NVENC/NVDEC。
- 宿主机验证：
nvidia-smi 正常；容器内 ffmpeg -hwaccels 能看到 cuda/nvdec。
- AMD 平台：使用 VAAPI（amdgpu 驱动）。
- 验证是否走硬件：Jellyfin 后台 > 仪表盘 > 播放，查看“转码信息”中的 Decoder/Encoder 是否为 VAAPI/Quick Sync/NVENC/NVDEC。
- 注意：部分 10-bit H.264 在消费级 GPU 上硬件解码支持不佳，必要时改走软件解码或转码为 H.265/AV1。
二 画质相关播放设置
- 客户端播放器：优先使用 Jellyfin Media Player；若遇到卡顿或画质不理想，可切换 LibVLC 作为备选。
- 浏览器直连：在 macOS（Safari）/Windows 10+（Edge） 可启用 HEVC 直接串流（H.265 SDR），在用户 > 设置 > 播放中勾选 “优先使用 fMP4-HLS 媒体容器”，避免转码、保留 HDR。
- 转码质量：播放 > 转码，将 视频质量设为 最高（无上限）；若带宽有限，再按需下调。
- 字幕渲染：若出现中文方块乱码，安装中文字体（如 fonts-noto-cjk）。
三 网络与缓存优化
- 带宽与并发：在 用户 > 播放 设置合适的 远程带宽限制；在 服务器 > 播放 > 转码 限制 并发转码数，避免过载导致降码率。
- 缓存与 I/O：启用 媒体库/转码缓存 并适当增大缓存大小；将 Jellyfin 数据与转码目录 放在 SSD/NVMe，减少卡顿与读写瓶颈。
- 网络路径：尽量使用 有线千兆/2.5G 或 Wi‑Fi 5/6，避免无线信号干扰与带宽波动。
四 Intel 平台进阶优化
- 开启 GuC/HuC 低电压模式（Gemini Lake、Jasper Lake、Elkhart Lake、N5105 等平台收益明显，亦有助于 OpenCL 色调映射速度）：
- 安装固件：
sudo apt install -y linux-firmware
- 启用 GuC/HuC：
echo "options i915 enable_guc=2" | sudo tee /etc/modprobe.d/i915.conf
- 更新并重启：
sudo update-initramfs -u && sudo update-grub && sudo reboot
- 验证：
cat /sys/kernel/debug/dri/0/i915_guc_load_status 与 i915_huc_load_status 均应为 RUNNING。
- 实测在 J4105/UHD600 上，开启后可提升 4K HDR HEVC 的转码与色调映射效率。
五 源媒体与编码策略
- 优先获取 高效编码 与 高码率 版本：如 H.265/HEVC、AV1（若设备支持），在相同主观画质下体积更小、带宽占用更低；播放端支持时尽量 直连不转码。
- 若片源为 H.264 10-bit 等硬件支持不佳的编码，建议在入库前转码为 H.265/AV1，或启用转码并选择 硬件编码器 与合适的码率/质量参数。
- 定期更新 Jellyfin 与 ffmpeg-jellyfin，获取更好的解码器兼容性与性能修复。
