温馨提示×

centos下jellyfin如何配置

小樊
36
2026-09-06 01:35:35
栏目: 智能运维

CentOS 下配置 Jellyfin 一般分为几个步骤:安装、基础配置、媒体库设置、以及常见的权限/防火墙问题处理。下面以 CentOS 7 / 8(含 Stream) 为例说明。


一、安装 Jellyfin

1. 安装依赖

sudo yum install -y epel-release
sudo yum install -y ffmpeg

如果是 CentOS 8 / Stream:

sudo dnf install -y epel-release
sudo dnf install -y ffmpeg

2. 添加 Jellyfin 官方仓库

sudo rpm --import https://repo.jellyfin.org/jellyfin_team.gpg

创建 repo 文件:

sudo tee /etc/yum.repos.d/jellyfin.repo <<EOF
[jellyfin]
name=Jellyfin
baseurl=https://repo.jellyfin.org/centos/\$releasever/\$basearch/
gpgcheck=1
gpgkey=https://repo.jellyfin.org/jellyfin_team.gpg
enabled=1
EOF

3. 安装 Jellyfin

sudo yum install -y jellyfin

4. 启动并设置开机自启

sudo systemctl enable --now jellyfin

查看状态:

sudo systemctl status jellyfin

二、防火墙配置

Jellyfin 默认端口是 8096

sudo firewall-cmd --permanent --add-port=8096/tcp
sudo firewall-cmd --reload

浏览器访问:

http://服务器IP:8096

三、初始化配置(Web 页面)

  1. 设置管理员账号
  2. 添加媒体库
    • 类型:电影 / 电视剧 / 音乐
    • 路径示例:
      /data/movies
      /data/tv
      
  3. 元数据语言选择「中文(简体)」
  4. 完成初始化

四、媒体目录权限(重点)

假设媒体目录是 /data/movies

sudo chown -R jellyfin:jellyfin /data
sudo chmod -R 755 /data

如果你用的是 SELinux(CentOS 默认开启):

sudo setsebool -P httpd_can_read_user_content 1
sudo semanage fcontext -a -t httpd_sys_content_t "/data(/.*)?"
sudo restorecon -Rv /data

五、硬件转码(可选)

Intel 核显

sudo yum install -y intel-media-driver

Jellyfin → 控制台 → 播放 → 启用硬件加速 → VAAPI

NVIDIA

需要安装驱动 + nvidia-container-toolkit(不在 yum 默认源)


六、常见问题

1. 无法访问页面

  • 检查防火墙
  • 检查 Jellyfin 是否运行
sudo systemctl status jellyfin
journalctl -u jellyfin -f

2. 扫描不到媒体文件

  • 权限问题(最常见)
  • SELinux 未放行

3. 播放卡顿

  • 启用硬件转码
  • 检查带宽 & 客户端码率

七、目录结构建议

/data
 ├── movies
 ├── tv
 └── music

如果你告诉我:

  • CentOS 具体版本(7 / 8 / Stream)
  • 是否有 GPU
  • 媒体文件放在哪(本地 / NFS / SMB)

我可以给你一份更精确的配置方案

0