clion007/jellyfin

clion/jellyfin 镜像文档

镜像概述

clion/jellyfin 是基于 Alpine 构建的 Jellyfin 媒体系统容器镜像，提供比官方镜像更优的使用体验。Jellyfin 是一款免费开源的媒体管理与流媒体系统，可替代闭源的 Emby 和 Plex，支持从专用服务器向多终端设备流式传输媒体内容。本镜像基于最新 Alpine 系统，具有更小的体积，修复了中文显示乱码、FFmpeg 解码异常及硬件驱动兼容问题，并支持自动检测更新至最新 Jellyfin 版本。

核心功能与特性

• 轻量级设计：基于 Alpine 构建，镜像体积更小，资源占用更低
• 问题修复：解决中文显示乱码、FFmpeg 解码问题及硬件驱动兼容性问题
• 自动更新：自动检测并更新至最新 Jellyfin 版本
• 硬件加速：支持 Intel/ATI/AMD 显卡硬件加速，提升媒体处理性能
• 跨平台支持：基于 .NET Core 框架，实现全平台兼容

使用场景与适用范围

• 家庭媒体服务器搭建，实现电影、音乐、照片等媒体文件的集中管理与流式传输
• 多设备媒体共享，支持通过 Web UI、手机 App、智能电视等多终端访问
• 对官方镜像中文显示、硬件加速等功能有优化需求的用户

使用方法与配置说明

Web UI 访问

容器启动后，可通过 http://<主机IP>:8096 访问 Jellyfin Web 管理界面。更多使用细节可参考 Jellyfin 官方文档。

Docker CLI 部署示例

bash
docker run -d \
  --name=Jellyfin \
  -e 'UMASK'='022' \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -e JELLYFIN_PublishedServerUrl=192.168.0.5 `# 可选，设置自动发现响应的域名或IP` \
  -p 8096:8096 \
  -p 8920:8920 `# 可选，HTTPS Web UI（需自行配置证书）` \
  -p 7359:7359/udp `# 可选，允许客户端在本地网络发现Jellyfin` \
  -p 1900:1900/udp `# 可选，DNLA和客户端使用的服务发现` \
  -v /path/to/config:/config \
  -v /path/to/video:/video \
  --restart unless-stopped \
  clion007/jellyfin

参数说明

容器通过运行时参数进行配置，格式为 <外部>:<内部>。

端口映射 (-p)

• 8096: HTTP Web UI 端口
• 8920（可选）: HTTPS Web UI 端口（需自行配置证书）
• 7359/udp（可选）: 本地网络客户端发现端口
• 1900/udp（可选）: DNLA和客户端服务发现端口

环境变量 (-e)

• PUID=1000: 用户ID，用于解决卷挂载权限问题
• PGID=1000: 组ID，用于解决卷挂载权限问题
• TZ=Asia/Shanghai: 时区设置，如“Asia/Shanghai”表示中国上海时区
• JELLYFIN_PublishedServerUrl=192.168.0.5（可选）: 设置自动发现响应的域名或IP地址
• UMASK=022（可选）: 覆盖容器内服务的默认umask设置

卷挂载 (-v)

• /config: Jellyfin 数据存储目录，建议持久化，大型媒体库可能需要50GB以上空间
• /video: 媒体文件目录，可根据需求添加多个，如/video/movies、/video/tv等

硬件加速配置

对于 Intel/ATI/AMD 显卡，需挂载 /dev/dri 设备以启用硬件加速：

bash
--device=/dev/dri:/dev/dri

容器会自动确保内部 jellyfin 用户拥有访问该设备的适当权限。

Umask 设置

所有镜像支持通过 -e UMASK=022 覆盖容器内服务的默认 umask 设置。注意 umask 是从权限中减去值，而非添加权限。

用户/组ID说明

使用卷挂载（-v 标志）时，主机与容器可能出现权限问题。通过指定 PUID（用户ID）和 PGID（组ID），确保主机上的卷目录与指定用户拥有相同的所有权，可避免权限问题。