CentOS 上部署 Jellyfin 的主要限制与对策
一 系统与版本支持
- 版本适配：Jellyfin 在 CentOS 7（如 7.9+） 上兼容性最好；CentOS Stream 8/9 可通过调整软件源或使用 Docker 方式运行，但需关注内核与软件包变动带来的兼容性风险。若追求“开箱即用”的稳定性，优先选择 CentOS 7.9。
- 安装方式：支持 RPM 包 与 Docker 两种部署。RPM 方式需准备依赖与 FFmpeg；Docker 方式可简化依赖与环境差异，便于跨版本迁移。
二 依赖与软件栈限制
- 基础依赖：必须确保系统已安装 libicu、fontconfig 等基础库，否则核心功能（如字符编码、字体渲染）会异常。
- 转码依赖：FFmpeg 是视频转码的关键组件。RPM 方式建议通过 RPM Fusion 源安装；若 RPM 环境中 FFmpeg 路径或版本不易确认，可采用官方静态编译包解压至 /usr/bin 并在 Jellyfin 控制台手动指定 FFmpeg 路径，以避免“找不到编码器/转码失败”。
三 安全与网络限制
- 防火墙：默认 Web 端口为 8096（HTTP）/8920（HTTPS），以及 DLNA 1900/UDP、mDNS 5353/UDP。需在 firewalld 中放行，否则外网无法访问：
firewall-cmd --permanent --zone=public --add-port=8096/tcp
firewall-cmd --permanent --zone=public --add-port=8920/tcp
firewall-cmd --permanent --zone=public --add-port=1900/udp
firewall-cmd --permanent --zone=public --add-port=5353/udp
firewall-cmd --reload
- SELinux：启用时可能阻止 Jellyfin 的网络访问或文件读写，可临时或持久化放宽策略，例如：
setsebool -P httpd_can_network_connect 1
如遇权限类报错，需同步校正媒体目录、配置目录与日志目录的属主/权限。
四 硬件加速与驱动限制
- 能力边界：能否启用 Intel Quick Sync（QSV）/NVIDIA NVENC 取决于 CPU/GPU、驱动版本与内核模块，未满足前置条件会导致硬件加速选项不可用或转码失败。
- 容器场景：Docker 下需将 /dev/dri 设备透传给容器，并确保容器内驱动匹配；常见做法是添加参数：
–device /dev/dri/renderD128:/dev/dri/renderD128 --device /dev/dri/card0:/dev/dri/card0
进入容器后可用 vainfo 验证驱动与解码能力，再在 Jellyfin 控制台选择 QSV 并开启硬件解码/编码。
五 性能与运维限制
- 常见瓶颈：CPU 算力不足、内存紧张、HDD 替代 SSD 导致 I/O 慢、并发连接过多、未启用缓存、编码格式低效（如大量 HEVC 软解）、带宽不足 等，都会直接影响流畅度与稳定性。
- 优化要点：
- 启用并合理设置缓存目录（如 /etc/jellyfin/config/config.yaml 中的 cache 相关项）；
- 通过 systemd 调整服务内存上限（如 MemoryMax），避免 OOM；
- 限制 MaxConcurrentSessions，避免过载；
- 在 Jellyfin 控制台开启 QSV/NVENC 等硬件加速，降低 CPU 占用；
- 适度使用带宽限制（服务端或网关侧），保障多用户场景稳定性。
