mlius/jellyfin

Jellyfin 媒体服务器镜像

镜像概述

本镜像基于官方jellyfin/jellyfin构建，是一款开源媒体服务器解决方案，用于搭建个人或家庭媒体中心。它能够集中管理影视、音乐、图片等媒体资源，并通过网络流式传输到电脑、手机、智能电视等多种设备，提供丰富的媒体播放体验。

核心功能与特性

• 媒体管理：支持多种媒体类型（电影、电视剧、音乐、图片等）的组织、分类和元数据管理
• 流式传输：支持将媒体内容实时流式传输到各类设备，自适应不同网络环境
• 硬解加速：支持显卡设备直通，实现硬件解码，降低CPU占用，提升播放性能
• 元数据优化：通过配置host指向优化TMDB、TVDB等元数据服务连接，加速海报和影视信息获取
• 跨平台访问：支持Web界面及多平台客户端（Windows、macOS、Android、iOS等）

使用场景

• 家庭媒体中心：集中存储和管理家庭影视资源，实现多设备共享观看
• 个人媒体库：整理个人收藏的音乐、视频文件，支持随时随地访问
• 小型媒体服务：为小范围用户群体提供媒体流服务，如家庭聚会、小型办公环境

使用方法与配置说明

基本部署命令

bash
sudo docker run -d --name=Jellyfin -p 8096:8096 \
  -p 8920:8920 -p 7359:7359/udp -p 1900:1900/udp \
  -v /srv/jellyfin/config:/config -v /srv/jellyfin/cache:/cache -v /media:/media \
  -e TZ=Asia/Shanghai -e PUID=0 -e PGID=0 \
  --device=/dev/dri:/dev/dri \
  --add-host=api.themoviedb.org:13.224.161.90 \
  --add-host=api.themoviedb.org:13.35.8.65 \
  --add-host=api.themoviedb.org:13.35.8.93 \
  --add-host=api.themoviedb.org:13.35.8.6 \
  --add-host=api.themoviedb.org:13.35.8.54 \
  --add-host=image.tmdb.org:138.199.37.230 \
  --add-host=image.tmdb.org:108.138.246.49 \
  --add-host=api.thetvdb.org:13.225.89.239 \
  --add-host=api.thetvdb.org:192.241.234.54 \
  --restart unless-stopped \
  mlius/jellyfin:latest

参数详细说明

端口映射

• -p 8096:8096：Jellyfin Web界面和API端口（必填），用于访问管理界面和媒体流传输
• -p 8920:8920：HTTPS端口（可选），用于加密连接
• -p 7359:7359/udp：DLNA服务发现端口（可选），用于局域网设备发现
• -p 1900:1900/udp：SSDP服务端口（可选），用于设备服务发现

卷挂载

• -v /srv/jellyfin/config:/config：配置文件存储目录，包含用户设置、媒体库配置等，需持久化
• -v /srv/jellyfin/cache:/cache：缓存目录，存放转码缓存、临时文件等
• -v /media:/media：媒体文件目录，需指向主机上存放影视、音乐等资源的路径

环境变量

• -e TZ=Asia/Shanghai：设置容器时区为亚洲/上海
• -e PUID=0：运行容器的用户ID（0表示root权限）
• -e PGID=0：运行容器的用户组ID（0表示root权限）

硬件加速

• --device=/dev/dri:/dev/dri：将主机显卡设备直通给容器，启用硬件解码功能，提升视频转码效率

元数据加速配置

通过--add-host参数手动指定TMDB（电影数据库）和TVDB（电视数据库）相关服务的IP地址，绕过DNS解析，加速元数据和海报图片的获取：

• api.themoviedb.org：电影元数据API服务器
• image.tmdb.org：电影海报图片服务器
• api.thetvdb.org：电视剧元数据API服务器

重启策略

• --restart unless-stopped：容器退出时自动重启（手动停止除外），确保服务持续运行

访问方法

容器启动后，通过浏览器访问 http://<主机IP>:8096 即可打开Jellyfin Web界面，按照引导完成初始配置（创建管理员账户、添加媒体库等）。