martadinata666/jellyfin

Jellyfin 镜像文档

镜像概述

Jellyfin是一款开源媒体服务器软件，用于管理和流式传输个人媒体内容（视频、音频、图片等）。本镜像为个人构建版本，特别集成了更新的VAAPI（视频加速API）支持，旨在提供更高效的硬件视频解码加速能力，提升媒体播放性能。

核心功能与特性

• 媒体管理：支持组织和管理各类媒体文件，自动获取元数据（封面、描述、字幕等）
• 硬件加速：集成更新的VAAPI支持，利用GPU进行视频解码，降低CPU占用
• 多平台访问：通过Web界面、移动应用、智能电视等多种设备访问媒体内容
• 自定义配置：支持个性化媒体库设置、用户权限管理和播放偏好配置

使用场景与适用范围

• 个人或家庭媒体中心，用于集中管理和流式传输电影、电视剧、音乐等媒体文件
• 需要硬件加速以优化播放性能的场景，尤其适合低功耗设备或高清/4K媒体播放需求
• 希望自建媒体服务，避免依赖第三方流媒体平台的用户

使用方法与配置说明

前提条件

• 系统需支持VAAPI硬件加速（通常需要Intel或AMD显卡）
• 安装Docker和Docker Compose（如使用Compose配置）

Docker Run 命令示例

bash
docker run -d \
  --name jellyfin_server \
  --group-add 226 \  # 替换为实际的渲染组ID，通过`ls -aln /dev/dri`查看
  --device /dev/dri/:/dev/dri/ \
  -p 8097:8096 \
  -v ./data:/config \  # 本地配置目录
  -v /videos/pathVideos:/media/Videos:rw \  # 本地媒体文件目录
  --restart unless-stopped \
  martadinata666/jellyfin:git

Docker Compose 配置示例

yaml
---
version: "3.5"
services:
  server:
    image: docker.xuanyuan.run/martadinata666/jellyfin:git
    container_name: jellyfin_server
    group_add:
      - 226  # 替换为实际的渲染组ID，通过`ls -aln /dev/dri`查看
    devices:
      - /dev/dri/:/dev/dri/  # 挂载DRI设备以支持硬件加速
    ports:
      - 8097:8096  # 主机端口:容器端口（Jellyfin默认端口为8096）
    volumes:
      - ./data:/config  # 持久化配置数据
      - /videos/pathVideos:/media/Videos:rw  # 媒体文件目录（替换为实际路径）
    networks:
      - jellyfin
    restart: unless-stopped

networks:
  jellyfin:
    name: jellyfin

关键配置说明

• group_add：指定渲染组ID，确保容器有权限访问GPU设备，需根据实际系统调整
• devices：挂载/dev/dri目录以启用VAAPI硬件加速
• ports：默认映射容器8096端口到主机8097端口，可根据需要修改
• volumes：
  • /config：存储Jellyfin配置、元数据等持久化数据
  • /media/Videos：挂载本地媒体文件目录，需替换为实际媒体文件路径
• restart：设置为unless-stopped确保容器意外停止后自动重启