Ubuntu 上提升 Jellyfin 稳定性的实用方案
一 系统与基础环境
- 保持系统与软件为最新：定期执行 sudo apt update && sudo apt full-upgrade -y，及时修复漏洞与兼容性问题。
- 精简与固化依赖：移除不必要的包，减少冲突与资源占用；变更前做好快照或备份。
- 存储与文件系统：媒体与缓存优先使用 SSD/NVMe，并采用 ext4/xfs 等成熟文件系统；避免频繁 I/O 抖动。
- 资源监控与告警：常驻 htop/iotop/nvidia-smi（如有 NVIDIA），观察 CPU、内存、I/O、温度，提前识别瓶颈。
- 备份与回滚：定期备份 /var/lib/jellyfin、配置与数据库，变更采用“灰度→观察→固化”的节奏。
二 硬件加速与驱动
- Intel 核显：安装 intel-media-va-driver-non-free，在 Jellyfin 启用 QSV；支持的设备加载 GuC/HuC 固件可提升转码与色调映射效率，实测对 4K HDR→SDR 场景更稳。
- NVIDIA：安装专有驱动，Jellyfin 选择 NVDEC/NVENC；容器需正确映射 /dev/dri 与 /dev/nvidia* 设备。
- AMD：安装 mesa-vulkan-drivers 与 libva-mesa-driver，在 Jellyfin 启用 VAAPI。
- 验证路径：播放高码率或 HDR 视频，观察是否走硬解（Dashboard→播放→转码信息），并检查 CPU 占用是否显著下降。
三 Jellyfin 服务与配置
- 并发与会话：在配置中限制 MaxConcurrentSessions，避免过载导致崩溃或卡顿。
- 内存与缓存：通过 systemd 为 Jellyfin 设置合理的内存上限；启用并调整 缓存 以减少磁盘抖动与重复读取。
- 编码策略：优先使用高效编码（如 H.265/HEVC、AV1），减少转码概率；客户端能力允许时尽量“直连播放”。
- 播放器与兼容性：客户端播放异常时，可切换 LibVLC 或外部 VLC/Kodi，提升兼容性与稳定性。
- 字幕渲染：出现中文“方块乱码”时，安装中文字体（如 fonts-noto、fonts-wqy-zenhei）。
四 网络与存储访问
- 反向代理与 TLS：使用 Nginx/Apache 反向代理并启用 HTTPS，对外服务更稳更安全；设置合适的 缓存与超时。
- 防火墙与访问控制：启用 UFW，仅开放 SSH、HTTP/HTTPS；必要时限制来源网段。
- 局域网存储：NAS 建议使用 NFS 挂载媒体库，减少 SMB 锁争用与断连导致的扫描/播放异常。
- 带宽与并发：根据上行带宽与客户端数量设置合理的 码率上限 与 并发会话，避免网络拥塞。
五 部署方式与维护
- 部署选择：
- 原生 APT 安装：版本匹配清晰、集成系统服务，适合长期稳定运行的物理/虚拟机。
- Docker：环境隔离、迁移便捷；注意设备映射与权限（/dev/dri、/dev/nvidia*）。
- 升级与回滚：Jellyfin 与 ffmpeg-jellyfin 保持更新；重大版本升级前备份，出现异常可快速回滚。
- 日志与排障：
- 系统日志：sudo tail -f /var/log/syslog 观察服务异常与硬件 I/O 报错。
- Jellyfin 日志：Dashboard→日志，定位转码失败、播放器协商、权限等问题。
- 硬件与容量规划：低配设备优先“直连播放+预转码关键片源”；必要时升级 内存/SSD/网卡 以提升稳态。
