Jellyfin Docker镜像文档

概述与主要用途

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

核心功能与特性

开源免费

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

媒体管理能力

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

多设备支持

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

流式传输与转码

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

用户与权限管理

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

扩展性与定制化

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

使用场景与适用范围

家庭媒体中心

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

个人媒体库管理

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

小型团队/社区媒体共享

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

替代商业媒体服务

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

使用方法与配置说明

Docker部署准备

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

Docker Run快速部署

bash
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文件：

yaml
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

启动服务：