uryn/jellyfin

Jellyfin with Intel Quick Sync Video (QSV) 硬件加速镜像

镜像概述

本镜像基于官方Jellyfin媒体服务器，默认启用Intel Quick Sync Video (QSV)全硬件加速功能，旨在提供高效的媒体转码性能。支持多种稳定版本标签，针对不同Intel CPU架构进行优化，确保在Intel 12代及以后Alder Lake CPU等新平台上的兼容性。

可用标签

• latest: 最新稳定版本，默认启用QSV硬件加速
• l10.8.5-qsv: 基于官方Jellyfin v10.8.5，使用debian bullseye-slim基础镜像，集成5.19版本内核，优化支持Intel 12代Alder Lake及以后CPU
• 10.8.4-qsv: 基于官方Jellyfin v10.8.4，使用debian bullseye-slim基础镜像，集成5.18版本内核，优化支持Intel 12代Alder Lake及以后CPU
• 10.7.7-qsv: 基于官方Jellyfin v10.7.7，使用debian bullseye-slim基础镜像

核心功能与特性

• 完整QSV硬件加速：支持Intel Quick Sync Video技术，实现高效视频转码，降低CPU占用
• 多版本支持：提供多个稳定版本标签，适配不同使用需求
• 新CPU兼容性：特定版本集成高版本内核（5.18/5.19），优化支持Intel 12代Alder Lake及更新架构CPU
• 轻量级基础：基于debian stable-slim（bullseye-slim），保持镜像精简高效
• 与官方功能一致：保留Jellyfin全部核心功能，包括媒体库管理、流式传输、用户权限控制等

使用场景

• 家庭媒体服务器搭建，需要高效转码4K/HDR内容
• 基于Intel CPU（尤其是12代及以后Alder Lake架构）的设备部署
• 对媒体转码性能要求较高，希望减少CPU资源占用的场景
• 需要稳定可靠媒体服务的个人或小型组织

使用方法

基本部署（docker run）

bash
docker run -d \
  --name=jellyfin-qsv \
  --net=host \
  --device=/dev/dri:/dev/dri \  # 挂载Intel显卡设备，启用QSV加速
  -v /path/to/config:/config \   # 配置文件目录
  -v /path/to/media:/media \     # 媒体文件目录
  -v /path/to/cache:/cache \     # 缓存目录
  -e PUID=1000 \                 # 用户ID
  -e PGID=1000 \                 # 用户组ID
  -e TZ=Asia/Shanghai \          # 时区设置
  --restart unless-stopped \
  uryn/jellyfin:latest

Docker Compose配置

yaml
version: '3.8'

services:
  jellyfin-qsv:
    image: docker.xuanyuan.run/uryn/jellyfin:latest
    container_name: jellyfin-qsv
    network_mode: host
    devices:
      - /dev/dri:/dev/dri  # 必须挂载以启用QSV硬件加速
    volumes:
      - /path/to/config:/config
      - /path/to/media:/media
      - /path/to/cache:/cache
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    restart: unless-stopped

配置说明

必要挂载

• 设备挂载：必须挂载/dev/dri设备，否则无法启用QSV硬件加速
• 卷挂载：
  • /config: 存放Jellyfin配置文件，需持久化
  • /media: 媒体文件存储目录，根据实际媒体位置调整
  • /cache: 转码缓存目录，建议使用高速存储

环境变量

• PUID/PGID: 容器内运行用户的ID和组ID，用于权限控制，建议设置为宿主机当前用户ID
• TZ: 时区设置，如Asia/Shanghai
• 其他Jellyfin官方支持的环境变量（如JELLYFIN_PublishedServerUrl等）

注意事项

• 确保宿主机Intel CPU支持Quick Sync Video技术（通常酷睿系列CPU均支持）
• 对于12代及以后Intel CPU，建议使用l10.8.5-qsv或10.8.4-qsv标签以获得最佳兼容性
• 首次启动后需通过Web界面（默认端口8096）完成初始配置，并在"服务器设置-硬件加速"中确认QSV加速已启用