如何在Linux上搭建Jellyfin媒体库

在 Linux 上搭建 Jellyfin 媒体库

一 安装方式总览

• 原生包安装：适合 Debian/Ubuntu、CentOS/RHEL、Fedora、Arch，系统级部署、易维护。
• Docker 安装：适合 任何发行版，隔离依赖、迁移方便，命令简单。
• 快速脚本：官方提供 Debian/Ubuntu 一键安装脚本，适合快速上手。

二 原生包安装步骤

• Ubuntu/Debian
  1. 安装依赖与密钥 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
  2. 添加仓库（自动识别发行版代号） echo “deb [signed-by=/etc/apt/keyrings/jellyfin.gpg] https://repo.jellyfin.org/$(awk -F’=’ ‘/^ID=/{print $NF}’ /etc/os-release) $(awk -F’=’ ‘/^VERSION_CODENAME=/{print $NF}’ /etc/os-release) main” | sudo tee /etc/apt/sources.list.d/jellyfin.list
  3. 安装与启动 sudo apt update && sudo apt install -y jellyfin sudo systemctl enable --now jellyfin
• CentOS/RHEL 7（RPM 本地安装）
  1. 安装 FFmpeg（转码依赖） 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 RPM（示例版本，可按需替换） wget https://repo.jellyfin.org/releases/server/centos/versions/stable/web/10.6.4/jellyfin-web-10.6.4-1.el7.noarch.rpm wget https://repo.jellyfin.org/releases/server/centos/versions/stable/server/10.6.4/jellyfin-server-10.6.4-1.el7.x86_64.rpm wget https://repo.jellyfin.org/releases/server/centos/versions/stable/server/10.6.4/jellyfin-10.6.4-1.el7.x86_64.rpm sudo yum localinstall -y jellyfin-*.rpm
  3. 启动与开机自启 sudo systemctl enable --now jellyfin
• Arch Linux
  • 使用 AUR 助手安装（示例：yay） yay -S jellyfin sudo systemctl enable --now jellyfin

三 Docker 安装步骤

• 安装 Docker（略，请参考 Docker 官方文档）。
• 拉取镜像并启动（示例采用 host 网络，更省端口映射；如需桥接，请改用 -p 8096:8096） docker run -d
  –name=jellyfin
  –net=host
  -v /path/to/config:/config
  -v /path/to/media:/media
  -v /path/to/cache:/cache
  –restart=unless-stopped
  jellyfin/jellyfin
• 访问地址：http://<服务器IP>:8096（使用桥接时）

四 首次配置与媒体库添加

• 访问 http://<服务器IP>:8096，完成向导：创建管理员账户、选择 元数据语言、添加媒体库（选择内容类型如 电影/剧集/音乐，指定媒体文件夹路径）、设置 远程访问（按需开启）。
• 文件权限与可见性
  • Jellyfin 会创建系统用户 jellyfin。若媒体目录不可见，授予读取权限： sudo chown -R jellyfin:jellyfin /your/media/folder
  • 更优雅的做法：创建共享组（如 media），将 jellyfin 与上传用户加入该组，并对目录设置合适的 组读写 权限。
• 刷新库与实时识别
  • 新文件上传后若未自动出现，进入对应媒体库执行 Scan Library 或 Refresh Metadata。
  • 默认不实时监控文件变动，需要手动刷新或按需配置。

五 防火墙与远程访问

• 防火墙放行（示例）
  • firewalld（CentOS 7+） sudo firewall-cmd --zone=public --add-port=8096/tcp --permanent sudo firewall-cmd --reload
  • ufw（Debian/Ubuntu） sudo ufw allow 8096/tcp
• 远程访问与安全建议
  • 不建议直接暴露 8096 端口到公网。可使用 反向代理（Nginx/Apache + HTTPS）、Tailscale/Zerotier 等内网穿透方案，或路由器 端口映射 + 强密码/二步验证。
  • 如需外网域名访问，建议配置 Nginx/Apache 反向代理与 Let’s Encrypt 证书，并在代理层限制访问来源与速率。

六 常见问题与优化

• 转码与硬件加速
  • 安装 FFmpeg（如 CentOS 7 通过 RPM Fusion）。硬件转码需主机与驱动支持（如 Intel Quick Sync、NVIDIA NVENC），在 Jellyfin 控制台启用对应选项可获得更流畅播放与更低 CPU 占用。
• 权限与目录可见性
  • 确保 jellyfin 用户对媒体目录具备读取权限；共享组方案便于多用户/多服务协同管理。
• 新文件未识别
  • 手动执行 Scan Library/Refresh Metadata；若需自动识别，可结合系统 inotify 工具或第三方插件实现。