CentOS 上 Jellyfin 安装失败的排查与修复
一 快速定位问题
- 确认系统版本与架构：执行 cat /etc/centos-release 与 uname -m，确保下载的 RPM 包与系统版本/架构匹配（如 x86_64 或 aarch64）。
- 查看安装阶段报错：若是 yum/dnf 安装 失败，注意终端输出的依赖冲突或下载错误；若是 rpm -ivh 失败，优先检查依赖与签名。
- 安装后启动失败：执行 systemctl status jellyfin -l 查看状态，随后用 journalctl -xeu jellyfin 与 tail -f /var/log/jellyfin/jellyfin.log 定位具体错误。
- 访问测试：确认端口 8096（HTTP）是否可达，必要时暂时关闭防火墙或云安全组策略做验证。
以上步骤能快速判断是“安装依赖/仓库问题”还是“服务启动/配置问题”。
二 依赖与仓库修复
- 安装基础依赖：执行 sudo yum install -y libicu fontconfig，缺少这些库会导致运行期异常。
- 启用 EPEL 与 RPM Fusion 并安装转码器：
- sudo yum install -y epel-release
- 对于 CentOS 7：sudo yum install -y https://download1.rpmfusion.org/free/el/rpmfusion-free-release-7.noarch.rpm
- 安装 FFmpeg：sudo yum install -y ffmpeg（Jellyfin 转码依赖）。
- 建议优先使用仓库安装而非手动 rpm，避免遗漏依赖；若必须 rpm，不要滥用 –nodeps，以免隐藏真实依赖问题。
上述依赖与 FFmpeg 是 Jellyfin 正常工作的前提。
三 正确的安装方式
- 方式 A（推荐）— 使用官方仓库：按官方指引添加 Jellyfin 仓库 后用 yum/dnf 安装，可自动解决依赖与升级。
- 方式 B — 手动下载 RPM 安装（示例为 10.8.9，请替换为最新稳定版）：
- 下载：
- wget -c https://repo.jellyfin.org/releases/server/centos/stable/web/jellyfin-web-10.8.9-1.el7.noarch.rpm
- wget -c https://repo.jellyfin.org/releases/server/centos/stable/server/jellyfin-server-10.8.9-1.el7.x86_64.rpm
- wget -c https://repo.jellyfin.org/releases/server/centos/stable/server/jellyfin-10.8.9-1.el7.x86_64.rpm
- 安装：
- 推荐：sudo yum install -y jellyfin-web-.rpm jellyfin-server-.rpm jellyfin-*.rpm
- 若依赖冲突且已确认仓库无误，再考虑：sudo rpm -Uvh --nodeps 包名（不建议作为首选）。
- 启动与自启：
- sudo systemctl start jellyfin
- sudo systemctl enable jellyfin
- 访问初始化：打开浏览器访问 http://服务器IP:8096 完成设置。
以上流程覆盖仓库与手动两种安装路径，并给出启动与访问要点。
四 常见报错与对应处理
- 依赖缺失（如 libicu、fontconfig）：安装缺失依赖后重装。
- 端口不通或访问不到 8096：
- 防火墙放行：sudo firewall-cmd --zone=public --add-port=8096/tcp --permanent && sudo firewall-cmd --reload
- 如使用 SELinux，排查策略限制或临时 setenforce 0 验证。
- 启动失败但无明确提示：查看 /var/log/jellyfin/jellyfin.log 与 journalctl，常见为配置错误或权限问题。
- FFmpeg 未就绪或路径异常：确保已通过 RPM Fusion 安装 FFmpeg，并在 Web 管理端设置正确的 FFmpeg 路径。
- 不建议使用 –nodeps 强行安装，可能引入运行时崩溃或功能缺失。
以上为高频问题及处置要点，可覆盖大多数安装/启动阶段的报错场景。
五 仍未解决时建议准备的信息
- 执行并贴出：cat /etc/centos-release、uname -m、yum repolist、systemctl status jellyfin -l、journalctl -xeu jellyfin、tail -n50 /var/log/jellyfin/jellyfin.log 的输出，便于精确定位。
