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 加速。

0 赞

0 踩