CentOS 上优化 Jellyfin 播放体验的实用清单
一 系统与基础优化
- 保持版本与依赖为最新稳定版，及时修复性能与稳定性问题；定期执行系统与安全更新（如 yum/dnf 更新），并定期备份配置与数据，降低回滚成本。
- 调整服务资源边界：编辑 /etc/systemd/system/jellyfin.service，按需设置 MemoryMax/MemoryMin，避免 OOM 或内存抖动影响播放。
- 优化 I/O 路径：将 Jellyfin 的缓存目录迁移到更快的 SSD/NVMe（如 /cache），减少封面、缩略图与转码临时文件的读写瓶颈。
- 控制并发与负载：在控制台设置合理的最大并发会话数（MaxConcurrentSessions），避免过多并发转码拖垮服务器。
- 网络 QoS：在网关/交换机或系统层面为媒体流量设置优先级与限速，减少家庭/办公网络拥塞时的卡顿与抖动。
二 转码与硬件加速
- 优先使用硬件加速以降低 CPU 占用、提升多路并发能力：
- Intel 平台启用 Quick Sync Video（QSV）：宿主机安装 Intel media-driver（iHD），Jellyfin 控制台“播放”选择 Hardware Acceleration: Intel Quick Sync (QSV)，并勾选“启用硬件解码”。
- 容器场景：映射 /dev/dri 设备到容器，直通核显给 Jellyfin 使用。
- 注意：Jellyfin 官方 Docker 镜像因协议原因通常不含 iHD 驱动；可选择社区维护的 nyanmisaka/jellyfin 镜像（已集成驱动与补丁），或自行在宿主机准备驱动环境。
- 调优转码行为：在“播放”中合理设置转码线程数，避免占满 CPU；启用转码节流，在播放进度稳定后降低转码速度，节省资源。
- 编码策略：尽量使用高效编码（如 H.264/H.265/AV1）的源文件，减少实时转码概率；对移动端或弱网用户，优先直连或选择较低码率的自适应码率播放。
三 Docker 部署要点（如适用）
- 目录与端口：将 /config、/cache、/media 挂载到宿主机持久化存储；映射 8096（HTTP）/8920（HTTPS）/7359 UDP（自动发现）/1900 UDP（DLNA），保证局域网发现与播放正常。
- 硬件直通与重启策略：添加 –device=/dev/dri:/dev/dri 直通核显；使用 –restart unless-stopped 提升可用性。
- 镜像选择：如需 QSV 且希望开箱即用，可选 nyanmisaka/jellyfin:latest；如需官方镜像，请在宿主机预装 iHD 驱动并确保容器可访问 /dev/dri。
四 网络与客户端侧优化
- 局域网体验：确保播放终端与服务器在同一网段/VLAN，优先使用有线千兆或 Wi‑Fi 5/6；必要时为媒体流量做带宽与优先级保障（QoS）。
- 外网访问：避免直接暴露服务到公网，建议使用 Tailscale 等内网穿透/组网方案，兼顾安全与稳定性。
- 移动端适配：优先使用 Jellyfin 官方 App 或支持 MPV 的第三方播放器，获得更好的解码与字幕兼容；不同设备与网络条件下进行实机测试并微调码率与缓冲策略。
五 监控与故障排查
- 建立监控与日志体系：定期查看 Jellyfin 日志与系统资源（CPU、内存、I/O、温度），必要时引入 Prometheus + Grafana 做可视化监控与告警。
- 快速定位思路：播放卡顿先区分是网络带宽/抖动还是CPU/磁盘瓶颈；检查转码是否走硬件路径、线程是否打满、缓存是否命中；对异常会话抓取日志与时间线，定位转码原因与客户端网络质量。
