Ubuntu 上部署 Jellyfin 的最佳实践
一 安装与基础配置
- 使用官方 APT 仓库安装，便于获取更新与依赖一致性：导入 GPG 密钥，添加仓库源（Types: deb, URIs: https://repo.jellyfin.org/, Suites: $(lsb_release -cs), Components: main, Architectures: amd64, Signed-By: /etc/apt/keyrings/jellyfin.gpg），执行安装并启动服务（sudo apt install jellyfin -y；sudo systemctl start jellyfin；sudo systemctl enable jellyfin）。访问 http://<服务器IP>:8096 完成初始化。若使用 Docker，准备宿主机目录并运行容器（示例：docker run -d --name jellyfin -p 8096:8096 -v /config:/config -v /cache:/cache -v /media:/media --restart unless-stopped jellyfin/jellyfin）。为外网访问建议启用防火墙（sudo ufw allow “WWW Full”）。
二 硬件加速与驱动
- Intel 平台优先启用 Quick Sync Video（QSV）：安装驱动包（如 intel-media-va-driver-non-free），在 Jellyfin 后台启用硬件解码/转码（VAAPI/QSV），可显著降低 CPU 占用并提升多路转码稳定性。支持的处理器建议加载 GuC/HuC 固件以进一步提升转码效率。NVIDIA 平台安装专有驱动与 nvidia-container-toolkit，在 Docker 运行时添加 –gpus all 并选择 NVDEC/NVENC 作为硬件加速方式。部署完成后用 htop/nvidia-smi 观察 CPU/GPU 使用率，确认硬解生效与负载合理。
三 存储与网络优化
- 媒体存储优先使用本地 SSD/NVMe 或高性能阵列，提升元数据与封面加载、预加载与播放流畅度。若媒体在 NAS，推荐使用 NFS 挂载到本地路径，减少 SMB 协议在高并发下的抖动与锁竞争。网络侧确保链路稳定与带宽充足，按需开启 预加载 与合理的 缓存 策略，降低首帧卡顿与重复读取；外网访问通过 Nginx/Apache 反向代理 + HTTPS 暴露，避免直曝 8096 端口，同时获得压缩、缓存与访问控制等收益。
四 安全加固
- 保持系统与 Jellyfin 及时更新，采用 Docker 隔离运行环境，创建 非 root 专用用户并最小化权限。启用 UFW 仅放行必要端口（如 22/80/443），通过反向代理配置 HTTPS 证书（如 Let’s Encrypt/Certbot）。严格设置 /config /cache /media 等目录权限与所有权，避免越权访问；如条件允许，为管理员启用 MFA 多因素认证，并定期审计日志与访问规则。
五 稳定性与运维
- 保持系统与软件包 持续更新，精简无用组件降低资源争用。针对高并发场景，合理配置 MaxConcurrentSessions 限制并发会话，按硬件与带宽调优 缓存 与预加载策略。使用 htop/nvidia-smi 持续监控资源，异常时优先检查转码路数、磁盘 I/O 与网络抖动。对关键变更（驱动、内核、Jellyfin 大版本）先备份 /config 与数据库，再滚动升级并回滚验证。