ugeek/jellyfin

Jellyfin 镜像文档

镜像概述

Jellyfin 镜像（jellyfin/jellyfin:10.4.3-arm）是 jellyfin/jellyfin 的分支版本，专为 ARM 架构设计，是一款开源的自由软件媒体浏览器。它允许用户管理个人媒体库（如电影、音乐、照片等），并通过网络向各种设备流式传输媒体内容，提供跨平台的媒体播放体验。

核心功能与特性

• 媒体管理：自动组织和索引媒体文件，支持元数据抓取和海报墙展示
• 流式传输：支持多种设备（电脑、手机、智能电视等）的媒体流式播放
• 跨平台兼容：适配 ARM 架构设备，可在树莓派等嵌入式设备上运行
• 自由开源：基于 GPL 许可证，代码完全开放，无商业限制
• 个性化设置：支持用户账户管理、播放历史记录、自定义播放列表等

使用场景

• 家庭媒体中心：搭建个人或家庭媒体服务器，集中管理影视、音乐资源
• 嵌入式设备应用：在树莓派等 ARM 架构设备上部署，实现低功耗媒体服务
• 个人媒体库：整理和访问个人收藏的媒体文件，支持远程访问

使用方法

Docker Run 部署示例

docker
docker run -d \
  --name jellyfin \
  -v $HOME/docker/jellyfin/config:/config \  # 配置文件存储目录
  -v $HOME/docker/jellyfin/cache:/cache \   # 缓存文件存储目录
  -v $HOME/docker/media/jellyfin:/media \   # 媒体文件存储目录
  -e UID=1000 -e GID=1000 \                # 运行容器的用户ID和组ID
  -p 8096:8096 \                           # 映射Web管理端口
  jellyfin/jellyfin:10.4.3-arm

参数说明

挂载卷（-v）

• /config：存储Jellyfin的配置文件、数据库和元数据，需持久化存储
• /cache：存储临时缓存文件，如转码后的媒体数据
• /media：存放媒体文件（电影、音乐、照片等）的目录，需指向实际媒体文件位置

环境变量（-e）

• UID=1000：指定运行Jellyfin进程的用户ID，确保对挂载目录有读写权限
• GID=1000：指定运行Jellyfin进程的组ID，与UID配合使用

端口映射（-p）

• 8096:8096：Jellyfin Web管理界面和媒体流服务端口，通过http://<主机IP>:8096访问

配置说明

1. 初始设置：首次启动后，通过浏览器访问http://<主机IP>:8096，按照引导完成媒体库配置、用户创建等初始化步骤
2. 媒体库管理：在Web界面中添加媒体文件夹（对应/media挂载目录），系统会自动扫描并生成媒体库
3. 权限调整：确保宿主机上的config、cache、media目录权限与指定的UID/GID匹配，避免权限错误

注意事项

• 该镜像为ARM架构版本，仅适用于ARM设备（如树莓派），x86架构设备需选择对应版本
• 媒体文件目录（/media）应确保有足够存储空间，建议使用外部存储或大容量硬盘
• 转码功能对设备性能有要求，低配置设备建议降低转码质量或使用直接播放模式