Jellyfin

提示

如果你正在寻找 Jellyfin 可用的播放器客户端，请移步至这里。

🌐 支持平台与架构

类别	说明
平台	Linux、Windows 10/11 & Server、macOS、Docker、Termux
CPU 架构	amd64 (x86_64)、arm64 (aarch64)、armhf (armv7)
官方 Docker 镜像	jellyfin/jellyfin（Multi-arch 自动适配，推荐标签 latest 或固定版本如 10.9.x）

🐳 Docker 部署

1. 创建项目目录

mkdir -p ~/jellyfin && cd ~/jellyfin

2. 编写编排文件

docker-compose.yml

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    restart: unless-stopped
    user: "1000:1000"        # 替换为实际 UID:GID，避免权限问题
    ports:
      - "8096:8096"          # HTTP Web UI
      - "8920:8920"          # HTTPS Web UI (按需)
    volumes:
      - ./config:/config     # 配置与元数据
      - ./cache:/cache       # 转码缓存与临时文件（建议 SSD）
      - /path/to/media:/media # 替换为实际媒体路径
    devices:
      - /dev/dri:/dev/dri    # Intel/AMD 核显硬件加速（按需）
    environment:
      - TZ=Asia/Shanghai

获取 UID/GID

id -u && id -g

3. 启动服务

docker compose up -d

权限与转码说明

• 官方镜像默认以 root 运行，强烈建议通过 user: "UID:GID" 降权运行。
• 确保宿主机媒体目录与 ./config、./cache 对指定 UID/GID 具备 rwx 权限。
• NVIDIA 显卡转码需安装 nvidia-container-toolkit，并在 compose 中移除 devices，添加 deploy.resources.reservations.devices 配置。

---

🐧 Debian 系统部署

适用于 Debian 11/12 及 Ubuntu 20.04+。采用官方 APT 仓库安装。

1. 添加仓库与密钥

导入 GPG 密钥

sudo apt update && sudo apt install -y curl gnupg2 lsb-release
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.jellyfin.org/debian/jellyfin_team.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/jellyfin.gpg

配置 APT 源

echo "deb [signed-by=/etc/apt/keyrings/jellyfin.gpg] https://repo.jellyfin.org/debian $(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
sudo systemctl status jellyfin

3. 防火墙放行

sudo ufw allow 8096/tcp
sudo ufw allow 8920/tcp
sudo ufw reload

路径与权限

配置位于 /etc/jellyfin，数据与数据库位于 /var/lib/jellyfin，缓存位于 /var/cache/jellyfin，日志位于 /var/log/jellyfin。服务以 jellyfin 系统用户运行，媒体目录需授权：sudo chown -R jellyfin:jellyfin /path/to/media。

---

🪟 Windows 系统部署

适用于 Windows 10/11 及 Windows Server。

1. 下载安装包

访问 Jellyfin 官方下载页，选择 Windows 平台下载最新 .exe 安装程序。

2. 执行安装向导

1. 运行安装程序，点击 Next。
2. 自定义安装路径（建议非系统盘，如 D:\Jellyfin）。
3. 服务模式：勾选 Install as a Windows Service（推荐，后台静默运行且开机自启）。
4. 完成安装，服务自动启动。

3. 防火墙与访问

• 首次访问时 Windows 防火墙弹窗，勾选 专用网络 与 公用网络 并允许。
• 浏览器访问：http://localhost:8096（局域网使用 http://<IP>:8096）。

数据目录

Windows 服务模式下配置与数据默认存储在 %ProgramData%\Jellyfin\Server。桌面模式为 %LOCALAPPDATA%\Jellyfin。迁移需先停止 Jellyfin Server 服务，整体复制目录后通过安装程序或注册表重新指向。

---

⚙️ 初始化配置（全平台通用）

部署完成后访问 http://<服务器IP>:8096 进入向导：

1. 语言/时区：选择 Chinese Simplified 与对应时区。
2. 管理员账户：设置用户名与强密码。
3. 媒体库：添加库 → 选择类型 → 指定路径（Docker 为 /media/xxx，原生为绝对路径）→ 启用元数据下载与图像提取。
4. 网络：保持默认端口。外网访问建议后续配置反向代理。
5. 验证：进入 控制台 > 播放 > 转码，选择硬件加速类型（VAAPI/NVENC/AMF/QSV），保存后播放测试视频确认解码正常。

生产环境建议

• 定期备份 config 目录（含数据库、插件、用户配置）
• 转码缓存目录（Docker 的 ./cache 或 Debian 的 /var/cache/jellyfin）建议放在 SSD 以提升并发转码性能
• 媒体目录权限务必与运行用户匹配，避免元数据写入失败
• 外网访问务必配置 HTTPS 反向代理，禁止直接暴露 8096 端口