yangzfan/jellyfin

Jellyfin 媒体服务器镜像

镜像概述

Jellyfin 是一款开源的媒体服务器软件，该镜像提供了预配置的 Jellyfin 服务环境，可快速部署用于管理、转码和流式传输各类媒体文件（如电影、音乐、照片等）。支持多平台访问，通过 Web 界面或专用客户端（如手机、智能电视、流媒体设备）实现媒体内容的播放与管理。

核心功能与特性

• 媒体库管理：自动识别并组织媒体文件，支持元数据刮削（封面、简介、演员信息等）
• 跨设备访问：通过 Web 界面（8096 端口）或 HTTPS（8920 端口）在多种设备上访问媒体内容
• 实时转码：根据设备性能和网络状况自动调整媒体编码格式，确保流畅播放
• 用户权限控制：支持多用户管理，可针对不同用户设置媒体访问权限
• 自定义配置：支持通过环境变量和卷挂载自定义服务参数、媒体存储路径及时区等

使用场景

• 家庭媒体中心：集中管理家庭电影、音乐库，支持多设备共享播放
• 个人媒体库：整理个人收藏的媒体文件，实现随时随地访问
• 小型媒体服务：为小团队或社区提供媒体内容共享服务

使用方法

基本部署（docker run）

通过以下命令快速启动 Jellyfin 服务：

bash
docker run --name=jellyfin.server \
  --restart always \
  -e PGID=0 -e PUID=0 \
  -e TZ=Asia/Shanghai \
  -p 8096:8096 \
  -p 8920:8920 \
  -v /volume/Movie:/mnt/movie \
  -d docker.xuanyuan.run/yangzfan/jellyfin

参数说明：

• --name=jellyfin.server：容器名称，可自定义
• --restart always：容器退出时自动重启
• 环境变量：
  • PGID=0：运行服务的组ID（0为root组）
  • PUID=0：运行服务的用户ID（0为root用户）
  • TZ=Asia/Shanghai：设置时区为亚洲/上海
• 端口映射：
  • 8096:8096：Web 界面访问端口
  • 8920:8920：HTTPS 访问端口（需配置SSL证书）
• 卷挂载：
  • -v /volume/Movie:/mnt/movie：将宿主机的媒体文件目录（/volume/Movie）挂载到容器内的/mnt/movie，作为媒体库存储路径

扩展部署（docker-compose）

创建 docker-compose.yml 文件，配置更灵活的部署：

yaml
version: '3'
services:
  jellyfin:
    image: docker.xuanyuan.run/yangzfan/jellyfin
    container_name: jellyfin.server
    restart: always
    environment:
      - PGID=0
      - PUID=0
      - TZ=Asia/Shanghai
    ports:
      - "8096:8096"   # Web界面
      - "8920:8920"   # HTTPS
      - "7359:7359/udp" # 自动发现服务
      - "1900:1900/udp" # DLNA服务
    volumes:
      - /volume/Movie:/mnt/movie       # 电影库
      - /volume/Music:/mnt/music       # 音乐库（可选）
      - /volume/Photos:/mnt/photos     # 照片库（可选）
      - /path/to/config:/config        # 配置文件持久化（可选）
      - /path/to/cache:/cache          # 转码缓存（可选）

启动服务：

bash
docker-compose up -d

配置说明

媒体库设置

1. 服务启动后，通过 http://<服务器IP>:8096 访问 Jellyfin Web 界面
2. 首次登录需完成初始化向导，包括创建管理员账户、添加媒体库
3. 添加媒体库时，选择容器内的媒体路径（如 /mnt/movie），系统将自动扫描并组织媒体文件

高级配置

• 用户与权限：在“管理 > 用户”中创建多用户，设置不同媒体库的访问权限
• 转码设置：在“管理 > 服务器 > 转码”中调整转码质量、硬件加速等参数（需宿主机支持）
• 网络设置：配置端口、域名、SSL证书（通过挂载证书文件到容器实现HTTPS）

注意事项

• 权限问题：若宿主机媒体文件目录权限不足，可调整 PUID 和 PGID 为宿主机用户的ID（通过 id 命令查看）
• 性能优化：转码功能对CPU/GPU资源要求较高，建议在性能较好的设备上部署
• 数据备份：若需持久化配置，建议挂载 /config 目录到宿主机，避免容器重建导致配置丢失