Linux如何配置Jellyfin服务器

Linux 上配置 Jellyfin 服务器的完整指南

一 环境准备与安装方式

• 准备要点
  • 建议使用 64 位系统，磁盘预留充足（媒体与缓存分离）。
  • 媒体目录与缓存目录建议使用独立路径，便于备份与权限管理。
  • 若需外网访问，提前规划域名与证书（如 Let’s Encrypt）。
• 发行版安装一览
  • Ubuntu/Debian
    • 安装依赖与密钥：
      • sudo apt update & & sudo apt install -y apt-transport-https ca-certificates gnupg curl
      • 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 [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/jellyfin.gpg] https://repo.jellyfin.org/ubuntu $(lsb_release -cs) main” | sudo tee /etc/apt/sources.list.d/jellyfin.list
      • sudo apt update & & sudo apt install -y jellyfin
  • CentOS/RHEL
    • 安装 EPEL 与仓库并安装：
      • sudo yum install -y epel-release wget
      • sudo wget -O /etc/yum.repos.d/jellyfin.repo https://download.jellyfin.org/repository/jellyfin.repo
      • sudo yum install -y jellyfin
  • Arch Linux
    • 使用 AUR 助手（如 yay）：yay -S jellyfin 或 jellyfin-git
• 服务启动
  • sudo systemctl enable --now jellyfin
  • sudo systemctl status jellyfin（确认 Active: active (running)）

二 防火墙与端口放行

• 常用端口
  • 8096/TCP（HTTP 访问）、8920/TCP（HTTPS 访问）、1900/UDP（DLNA）、5353/UDP（mDNS/Bonjour）
• firewalld（CentOS/RHEL）
  • sudo firewall-cmd --zone=public --add-port=8096/tcp --permanent
  • sudo firewall-cmd --zone=public --add-port=8920/tcp --permanent
  • sudo firewall-cmd --zone=public --add-port=1900/udp --permanent
  • sudo firewall-cmd --zone=public --add-port=5353/udp --permanent
  • sudo firewall-cmd --reload
• UFW（Ubuntu/Debian）
  • sudo ufw allow 8096,8920/tcp
  • sudo ufw allow 1900,5353/udp
  • sudo ufw enable & & sudo ufw status

三 首次初始化配置

• 访问控制台
  • 浏览器打开：http://服务器IP:8096（或 https://IP:8920）
• 设置向导
  • 选择界面语言与地区，创建 管理员账户。
  • 添加媒体库：选择类型（电影/剧集/音乐等），指定媒体目录（如 /movies、/tv）。
  • 元数据语言与地区：选择 中文（简体） 等，提升刮削准确度。
  • 远程访问：勾选 允许远程访问 与（可选）自动端口映射。
  • 完成后进入仪表盘，开始浏览与播放。

四 反向代理与 HTTPS（Apache 示例）

• 安装与证书
  • sudo apt install -y apache2 certbot python3-certbot-apache
  • sudo certbot certonly --agree-tos --email you@example.com --webroot -w /var/www/html -d your.domain
• Apache 虚拟主机（/etc/apache2/sites-available/jellyfin.conf）
  • 启用模块：sudo a2enmod proxy proxy_http proxy_wstunnel headers ssl
  • 配置示例：

    <
        VirtualHost *:80>
        
        ServerName your.domain
        Redirect permanent / https://your.domain/
    <
        /VirtualHost>
        
    
    <
        VirtualHost *:443>
        
        ServerName your.domain
        SSLEngine on
        SSLCertificateFile /etc/letsencrypt/live/your.domain/fullchain.pem
        SSLCertificateKeyFile /etc/letsencrypt/live/your.domain/privkey.pem
    
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set X-Forwarded-Port "443"
    
        ProxyPreserveHost On
        ProxyPass        "/socket"  "ws://127.0.0.1:8096/socket"
        ProxyPassReverse "/socket"  "ws://127.0.0.1:8096/socket"
        ProxyPass        "/"        "http://127.0.0.1:8096/"
        ProxyPassReverse "/"        "http://127.0.0.1:8096/"
    <
        /VirtualHost>
        
    

  • 启用站点并重启：sudo a2ensite jellyfin.conf & & sudo systemctl reload apache2
• 提示
  • 若使用 Nginx，可用类似 proxy_pass 与 WebSocket 配置；证书路径与域名请替换为你的实际值。

五 权限与硬件加速

• 目录权限
  • 确保 Jellyfin 用户对媒体目录可读（示例）：
    • sudo chown -R jellyfin:jellyfin /movies /tv
    • sudo chmod -R 755 /movies /tv
• 硬件加速（可选）
  • Intel Quick Sync（主机或容器）
    • 主机：Jellyfin 控制台 → 播放 → 硬件加速 选择 VAAPI，FFmpeg 路径保持自动。
    • Docker：映射 /dev/dri 设备并加入 video 组（示例）：
      • docker run -d --name jellyfin
        -v /path/config:/config -v /path/cache:/cache -v /movies:/media
        -p 8096:8096
        –device /dev/dri/renderD128:/dev/dri/renderD128
        –device /dev/dri/card0:/dev/dri/card0
        –group-add video
        –restart unless-stopped
        jellyfin/jellyfin:latest
  • NVIDIA NVENC（容器）
    • 安装 NVIDIA 驱动 与 NVIDIA Container Toolkit，在容器内启用 GPU 并选择 NVENC 加速。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！