centos下jellyfin的设置指南

CentOS下Jellyfin设置指南

一、准备工作

1. 系统更新：运行sudo yum update -y确保系统为最新版本，避免兼容性问题。
2. 依赖包安装：Jellyfin依赖libicu（国际化支持）、fontconfig（字体渲染）等包，执行sudo yum install -y libicu fontconfig安装。
3. FFmpeg配置：Jellyfin需FFmpeg实现视频转码（如硬件加速），需先添加RPM Fusion源再安装：
   • sudo yum install -y epel-release（安装EPEL仓库）；
   • wget https://download1.rpmfusion.org/free/el/rpmfusion-free-release-7.noarch.rpm（下载RPM Fusion免费源）；
   • rpm -ivh rpmfusion-free-release-7.noarch.rpm（安装源）；
   • sudo yum install -y ffmpeg ffmpeg-devel（安装FFmpeg及开发包）。

二、安装Jellyfin

方式一：通过RPM包安装（推荐）

1. 下载RPM包：访问Jellyfin官方仓库下载CentOS对应的稳定版RPM包（以10.8.9为例）：
   • wget https://repo.jellyfin.org/releases/server/centos/stable/web/jellyfin-web-10.8.9-1.el7.noarch.rpm；
   • wget https://repo.jellyfin.org/releases/server/centos/stable/server/jellyfin-server-10.8.9-1.el7.x86_64.rpm；
   • wget https://repo.jellyfin.org/releases/server/centos/stable/server/jellyfin-10.8.9-1.el7.x86_64.rpm。
2. 本地安装：使用yum localinstall命令安装所有包（自动解决依赖）：
   sudo yum localinstall jellyfin-web-*.rpm jellyfin-server-*.rpm jellyfin-*.rpm。

方式二：通过Docker安装（快速部署）

1. 拉取镜像：运行docker pull jellyfin/jellyfin:latest获取最新版Jellyfin镜像。
2. 创建目录：建立配置、缓存和媒体存储目录：
   mkdir -p /srv/jellyfin/{config,cache,media}。
3. 运行容器：使用docker run命令启动容器（映射端口、挂载目录）：
   docker run -d --name jellyfin -p 8096:8096 --restart always --privileged -v /srv/jellyfin/config:/config -v /srv/jellyfin/cache:/cache -v /path/to/your/media:/media jellyfin/jellyfin:latest（/path/to/your/media替换为实际媒体路径）。

三、启动与启用服务

1. 启动服务：若通过RPM包安装，运行sudo systemctl start jellyfin启动Jellyfin服务。
2. 设置开机自启：执行sudo systemctl enable jellyfin，确保系统重启后自动启动。
3. 检查状态：通过sudo systemctl status jellyfin确认服务运行正常（显示“active (running)”）。

四、初始化配置（Web界面）

1. 访问界面：在浏览器输入http://服务器IP:8096（默认端口），进入初始化向导。
2. 基本设置：选择语言（如中文）、设置管理员账号（强密码）和密码。
3. 媒体库配置：点击“添加媒体库”，选择媒体类型（电影、电视剧等），设置媒体文件夹路径（如/media/movies），勾选“启用刮削”（自动获取海报、简介）。
4. 网络设置：开启DLNA（1900/udp）、UPnP等功能，方便智能设备访问。
5. 转码设置：进入“控制台→播放→设置”，确认FFmpeg路径（默认自动检测），开启硬件加速（如NVIDIA NVENC、Intel QSV，需对应驱动支持）。

五、防火墙配置

1. 放行端口：Jellyfin需开放以下端口：
   • HTTP（8096）：sudo firewall-cmd --zone=public --add-port=8096/tcp --permanent；
   • HTTPS（8920）：sudo firewall-cmd --zone=public --add-port=8920/tcp --permanent（可选，用于加密访问）；
   • DLNA（1900/udp）：sudo firewall-cmd --zone=public --add-port=1900/udp --permanent；
   • Bonjour/mDNS（5353/udp）：sudo firewall-cmd --zone=public --add-port=5353/udp --permanent。
2. 重载防火墙：执行sudo firewall-cmd --reload使规则生效。

六、可选优化（反向代理与SSL）

1. Nginx反向代理：若需通过域名访问或隐藏端口，可配置Nginx反向代理：
   • 安装Nginx：sudo yum install -y nginx；
   • 创建配置文件：sudo vi /etc/nginx/conf.d/jellyfin.conf，添加以下内容：

     server {
         listen 80;
         server_name your_domain.com;  # 替换为你的域名或IP
         location / {
             proxy_pass http://localhost:8096;
             proxy_set_header Host $host;
             proxy_set_header X-Real-IP $remote_addr;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
             proxy_set_header X-Forwarded-Proto $scheme;
         }
     }
     

   • 重启Nginx：sudo systemctl restart nginx。
2. 配置SSL：使用Let’s Encrypt免费获取SSL证书，实现HTTPS加密：
   • 安装Certbot：sudo yum install -y certbot python3-certbot-nginx；
   • 申请证书：sudo certbot --nginx -d your_domain.com（替换为你的域名）；
   • 按提示完成配置（自动重定向HTTP到HTTPS）。

七、常见问题排查

1. 媒体库不显示文件：检查Jellyfin用户（默认jellyfin）对媒体文件夹是否有读写权限（chown -R jellyfin:jellyfin /path/to/media）；国内网络需修改NAS hosts文件，解决TheMovieDB元数据搜刮问题。
2. 演员页加载失败：编辑Jellyfin配置文件（/etc/jellyfin/system.xml或Docker映射的/config/system.xml），禁用导致问题的功能（如“演员照片”）。
3. 无法访问Web界面：确认防火墙是否放行8096端口，或Jellyfin服务是否运行（systemctl status jellyfin）。