Linux如何安装Jellyfin服务器

Linux 安装 Jellyfin 服务器

一 安装前准备

• 以具有 sudo 权限的普通用户操作，先更新系统并安装常用工具：
  • Debian/Ubuntu：sudo apt update && sudo apt install -y apt-transport-https ca-certificates curl gnupg
  • RHEL/CentOS 7/8：sudo yum install -y epel-release && sudo yum update -y
• 准备媒体目录（示例：/data/media），并确认运行 Jellyfin 的系统用户（常见为 jellyfin）对该目录有读权限：
  • sudo mkdir -p /data/media
  • sudo chown -R jellyfin:jellyfin /data/media && sudo chmod -R 755 /data/media
• 浏览器访问地址将使用 http://服务器IP:8096 进入初始化向导。

二 发行版安装步骤

• Ubuntu/Debian（APT 仓库）
  1. 导入 GPG 密钥并添加仓库（推荐“signed-by”方式）：
     • sudo mkdir -p /etc/apt/keyrings
     • curl -fsSL https://repo.jellyfin.org/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg
     • echo “deb [signed-by=/etc/apt/keyrings/jellyfin.gpg] https://repo.jellyfin.org/$(lsb_release -is | tr ‘[:upper:]’ ‘[:lower:]’) $(lsb_release -cs) main” | sudo tee /etc/apt/sources.list.d/jellyfin.list
  2. 安装并启动服务：
     • sudo apt update && sudo apt install -y jellyfin
     • sudo systemctl enable --now jellyfin
• RHEL/CentOS 7（RPM 本地安装，稳定且通用）
  1. 安装 FFmpeg（推荐 RPM Fusion 源）：
     • sudo yum install -y epel-release
     • sudo yum install -y https://download1.rpmfusion.org/free/el/rpmfusion-free-release-7.noarch.rpm
     • sudo yum install -y ffmpeg
  2. 下载并安装 Jellyfin 组件（请选择与你系统匹配的版本号与架构）：
     • 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
     • sudo yum localinstall -y jellyfin-web-.rpm jellyfin-server-.rpm jellyfin-*.rpm
  3. 启动服务：
     • sudo systemctl enable --now jellyfin
• Arch Linux（AUR）
  • 使用 AUR 助手安装（示例：yay）：yay -S jellyfin 或 yay -S jellyfin-git
  • sudo systemctl enable --now jellyfin
• 其他说明
  • 部分教程提供直接添加 .repo 文件的方式（如 /etc/yum.repos.d/jellyfin.repo）；如网络可达也可使用，但请以官方仓库与系统版本匹配为准。

三 防火墙与端口

• 放行 Jellyfin 常用端口（firewalld）：
  • sudo firewall-cmd --permanent --add-port=8096/tcp # HTTP 访问
  • sudo firewall-cmd --permanent --add-port=8920/tcp # HTTPS 访问
  • sudo firewall-cmd --permanent --add-port=1900/udp # DLNA
  • sudo firewall-cmd --permanent --add-port=5353/udp # mDNS/Bonjour
  • sudo firewall-cmd --reload
• 如使用云服务器，还需在云平台安全组放行上述端口。

四 初始化与媒体库配置

• 在浏览器访问 http://<服务器IP>:8096，按向导完成：
  • 创建管理员账户与密码
  • 添加媒体库：选择类型（电影/剧集/音乐等），设置显示名称，指定媒体目录（如 /data/media）
  • 选择元数据语言与地区
  • 按需开启远程访问
• 若目录无法选择，回到系统确认目录权限与所有权（见“安装前准备”）。

五 常见问题与优化

• FFmpeg 与转码
  • 转码依赖 FFmpeg。RHEL/CentOS 建议通过 RPM Fusion 安装；其他发行版使用系统仓库或静态构建均可。
• 硬件加速（可选）
  • Intel Quick Sync：在宿主机安装驱动后，于 Jellyfin 控制台“播放”→“硬件加速”选择 Intel Quick Sync；容器部署需映射 /dev/dri 设备并赋予权限。
• 反向代理与 HTTPS（可选）
  • 使用 Nginx/Apache 反向代理并配置 Let’s Encrypt 证书，或直接启用 8920/tcp HTTPS 端口。示例（firewalld）：sudo firewall-cmd --permanent --add-service=http --add-service=https && sudo firewall-cmd --reload。