Linux版Jellyfin配置教程

Linux 版 Jellyfin 配置教程

一 环境准备与安装

• 发行版与方式：支持 Ubuntu/Debian、CentOS/RHEL、Arch Linux 等，常见方式为系统包管理器安装或 Docker 部署。
• Ubuntu/Debian 推荐步骤：
  • 安装依赖与密钥：
    • sudo apt update && sudo apt install -y apt-transport-https ca-certificates curl gnupg
    • 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/ubuntu $(lsb_release -cs) main” | sudo tee /etc/apt/sources.list.d/jellyfin.sources
    • sudo apt update && sudo apt install -y jellyfin
• CentOS/RHEL 7 示例（启用 EPEL 后使用官方仓库或直接安装 RPM）：
  • sudo yum install -y epel-release
  • 方式 A（仓库）：sudo wget -O /etc/yum.repos.d/jellyfin.repo https://download.jellyfin.org/repository/jellyfin.repo && sudo yum install -y jellyfin
  • 方式 B（RPM 包）：下载 server/web 组件后执行 sudo yum localinstall jellyfin-*.rpm
• Arch Linux：使用 AUR 助手安装，例如：trizen -S jellyfin 或 yay -S jellyfin-git
• Docker（可选）：docker pull jellyfin/jellyfin:latest，数据卷建议映射 /config、/cache、/media。

二 首次启动与基础配置

• 启动与自启：
  • sudo systemctl enable --now jellyfin
  • 检查状态：systemctl status jellyfin
• 访问控制台：浏览器打开 http://服务器IP:8096，进入向导设置管理员账户、语言与地区。
• 添加媒体库：选择内容类型（如电影/剧集/音乐），在“文件夹+”选择媒体目录。若目录不可见，修正权限与归属：
  • sudo chmod 755 -R /path/to/media
  • sudo chown jellyfin:jellyfin /path/to/media
• 元数据与远程访问：选择首选元数据语言，按需开启远程访问（外网访问请配合反向代理或路由器端口转发与 HTTPS）。

三 网络与防火墙配置

• firewalld（CentOS/RHEL）：
  • 放行端口：sudo firewall-cmd --permanent --zone=public --add-port=8096/tcp
  • 可选：sudo firewall-cmd --permanent --zone=public --add-port=8920/tcp（HTTPS）、1900/udp（DLNA）、5353/udp（mDNS）
  • 重载：sudo firewall-cmd --reload
• UFW（Ubuntu）：
  • 放行：sudo ufw allow 8096/tcp；或允许 “WWW Full”（80/443，若使用反向代理）
• 路由器端口转发（外网直连场景）：将公网 8096/8920 转发至内网服务器 IP 对应端口（建议仅在内网受信或配合反向代理/TLS 使用）。
• 反向代理与 HTTPS（推荐）：
  • Nginx/Apache 配置域名与证书，对外提供 443/HTTPS，内部反向代理到 http://127.0.0.1:8096
  • 可使用 Certbot 获取 Let’s Encrypt 证书并自动配置 Nginx/Apache。

四 硬件加速与转码优化

• Intel Quick Sync（常见于 Intel 核显）：
  • 宿主机安装驱动：sudo apt install intel-media-va-driver-non-free（或发行版对应版本）
  • Docker 场景需映射 /dev/dri 设备并加入 video 组（示例见下节）
  • Jellyfin 控制台：进入 控制台 → 播放 → 硬件加速，选择 Intel Quick Sync，保存并测试转码
• FFmpeg：Jellyfin 依赖 FFmpeg 完成转码。部分发行版仓库版本较旧，可使用 静态构建 放置于 /usr/bin 并确保可执行
• 验证：在“播放”中开启转码日志，播放影片观察是否走 VAAPI/Quick Sync。

五 常见问题与排障

• 媒体目录不可见或权限错误：
  • 确认路径存在且对 jellyfin 用户可读：ls -ld /path；必要时执行 chmod/chown 修正
• 服务无法启动或端口被占用：
  • 查看状态与日志：systemctl status jellyfin；journalctl -u jellyfin -xe
  • 检查端口占用：ss -ltnp | grep 8096
• 外网访问失败：
  • 核对 firewalld/ufw 与云安全组规则、路由器端口转发是否正确；优先使用 反向代理 + HTTPS
• 硬件加速不可用：
  • 核对驱动与设备权限（/dev/dri）、Jellyfin 硬件加速选项是否匹配、FFmpeg 是否为新版
• Docker 部署要点：
  • 目录映射：/config、/cache、/media
  • 权限与设备：–group-add video，–device /dev/dri:/dev/dri
  • 网络：建议 –nethost 或标准桥接并正确反向代理