Jellyfin Docker镜像文档

概述与主要用途

Jellyfin是一款开源、免费的媒体服务器软件，旨在为用户提供自托管的媒体管理与流式传输解决方案。作为商业媒体服务器的替代方案，Jellyfin允许用户完全控制自己的媒体数据，无需依赖第三方服务，保护隐私的同时提供丰富的媒体体验。其主要用途包括家庭媒体中心搭建、个人媒体库管理、跨设备媒体流式传输等场景。

核心功能与特性

开源免费

• 完全开源，基于GPLv2许可证，无隐藏费用或功能限制
• 社区驱动开发，持续更新与优化

媒体管理能力

• 自动获取媒体元数据（封面、简介、演员信息等）
• 支持媒体文件分类、排序与标签管理
• 智能识别媒体内容，按类型（电影、剧集、音乐、照片）组织

多设备支持

• 兼容Web浏览器、移动设备（iOS/Android）、智能电视、流媒体设备（如Roku、Fire TV）等
• 提供原生客户端与Web界面，确保跨平台一致性体验

流式传输与转码

• 支持实时媒体转码，适配不同网络环境与设备性能
• 自适应比特率流式传输，根据网络状况动态调整画质
• 支持多种媒体格式，无需手动转换文件格式

用户与权限管理

• 多用户支持，为不同用户创建独立媒体库
• 细粒度权限控制，可限制用户访问特定媒体内容
• 家长控制功能，过滤不适宜内容

扩展性与定制化

• 丰富的插件生态，支持功能扩展（如字幕下载、主题定制等）
• 可自定义媒体库视图、界面主题与播放设置

使用场景与适用范围

家庭媒体中心

• 搭建家庭共享媒体库，实现家庭成员多设备访问电影、电视剧、音乐等内容

个人媒体库管理

• 整理个人收藏的媒体文件，通过统一界面浏览与播放

小型团队/社区媒体共享

• 为小型团队或兴趣社区提供媒体文件共享与流式传输服务

替代商业媒体服务

• 作为Netflix、Spotify等商业服务的补充或替代，降低媒体消费成本

使用方法与配置说明

Docker部署准备

• 确保已安装Docker与Docker Compose
• 准备媒体文件存储目录（如视频、音乐文件夹）

Docker Run快速部署

docker run -d \
  --name jellyfin \
  -p 8096:8096 \  # Web界面与API端口
  -p 8920:8920 \  # HTTPS端口（可选）
  -p 7359:7359/udp \  # 自动发现端口（可选）
  -p 1900:1900/udp \  # DLNA服务端口（可选）
  -v /path/to/config:/config \  # 配置文件存储
  -v /path/to/cache:/cache \  # 缓存文件（转码缓存等）
  -v /path/to/media:/media \  # 媒体文件存储（可挂载多个目录）
  -e PUID=1000 \  # 运行容器的用户ID（避免权限问题）
  -e PGID=1000 \  # 运行容器的用户组ID
  -e TZ=Asia/Shanghai \  # 时区设置（如Asia/Shanghai）
  --restart unless-stopped \
  jellyfin/jellyfin

Docker Compose配置示例

创建docker-compose.yml文件：

version: '3.8'

services:
  jellyfin:
    image: jellyfin/jellyfin
    container_name: jellyfin
    ports:
      - "8096:8096"
      - "8920:8920"
      - "7359:7359/udp"
      - "1900:1900/udp"
    volumes:
      - ./config:/config
      - ./cache:/cache
      - /path/to/movies:/media/movies
      - /path/to/music:/media/music
      - /path/to/photos:/media/photos
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    restart: unless-stopped

启动服务：

docker-compose up -d

关键配置说明

端口映射

• 8096: 默认Web界面与API端口，用于访问Jellyfin管理界面
• 8920: HTTPS端口，启用HTTPS时使用（需配置SSL证书）
• 7359/udp: 服务自动发现端口，用于局域网内设备发现Jellyfin服务器
• 1900/udp: DLNA服务端口，支持DLNA设备访问

数据卷挂载

• /config: 存储Jellyfin配置文件、数据库等
• /cache: 存储转码缓存、临时文件等
• /media: 挂载媒体文件目录（可根据需求挂载多个子目录，如/movies、/music）

环境变量

• PUID: 运行Jellyfin进程的用户ID（建议设置为宿主机用户ID，避免权限问题）
• PGID: 运行Jellyfin进程的用户组ID
• TZ: 时区设置（如Asia/Shanghai、Europe/London等）

初始化配置

1. 部署完成后，通过http://<服务器IP>:8096访问Jellyfin Web界面
2. 按照引导创建管理员账户、添加媒体库（选择挂载的/media目录）
3. 配置媒体库类型（电影、电视剧、音乐等），Jellyfin将自动扫描并获取元数据
4. 完成设置后即可开始浏览与流式传输媒体内容

进阶配置

• HTTPS配置：通过反向代理（如Nginx）或内置SSL功能启用HTTPS
• 转码设置：在"控制台-播放"中调整转码性能参数，适配服务器硬件
• 用户管理：在"控制台-用户"中添加用户、配置权限与媒体访问范围
• 插件安装：在"控制台-插件"中搜索并安装插件，扩展功能