butterfly2sea/jellyfin

Jellyfin Docker镜像文档

镜像概述

Jellyfin是一个免费开源的媒体系统，旨在让用户完全控制媒体内容的管理和流式传输。作为Emby和Plex的替代方案，它基于.NET Core框架开发，实现了全平台支持，可在多种操作系统上运行。Jellyfin无任何附加条件、无 premium 许可或功能限制，也无隐藏议程，由社区团队协作开发，致力于打造更好的媒体服务体验。

核心功能与特性

• 免费开源：采用GPL 2.0许可证，源代码完全开放，无任何隐藏费用或功能限制
• 跨平台支持：基于.NET Core框架，支持Windows、Linux、macOS等多种操作系统
• 媒体管理：自动组织和管理媒体文件，支持元数据获取、封面生成、媒体分类等
• 多设备访问：通过多种客户端应用（Web、移动端、智能电视等）访问媒体内容
• 流式传输：支持视频、音频等媒体的实时流式传输，自适应码率调整
• 转码能力：集成ffmpeg，支持媒体文件转码以适应不同设备和网络条件
• 社区驱动：活跃的开发社区，持续更新和功能改进，支持多语言翻译

使用场景与适用范围

• 个人媒体中心：搭建个人媒体服务器，管理和播放本地视频、音乐、照片等
• 家庭流媒体服务：为家庭成员提供共享媒体访问，支持多用户权限管理
• 替代商业媒体服务：作为Emby、Plex等商业产品的免费开源替代方案
• 自托管服务：适合希望完全控制数据隐私和媒体内容的用户

使用方法与配置说明

基本Docker运行命令

使用以下命令快速启动Jellyfin容器：

bash
docker run -d \
  --name jellyfin \
  -p 8096:8096 \
  -p 8920:8920 \
  -v /path/to/config:/config \
  -v /path/to/cache:/cache \
  -v /path/to/media:/media \
  --restart=unless-stopped \
  docker.xuanyuan.run/jellyfin/jellyfin

参数说明：

• -p 8096:8096：HTTP访问端口映射
• -p 8920:8920：HTTPS访问端口映射（可选）
• -v /path/to/config:/config：配置文件存储目录
• -v /path/to/cache:/cache：缓存文件目录（转码缓存等）
• -v /path/to/media:/media：媒体文件目录（可挂载多个媒体目录）
• --restart=unless-stopped：容器退出时自动重启（除非手动停止）

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  jellyfin:
    image: docker.xuanyuan.run/jellyfin/jellyfin
    container_name: jellyfin
    ports:
      - "8096:8096"  # HTTP端口
      - "8920:8920"  # HTTPS端口（可选）
    volumes:
      - /path/to/config:/config
      - /path/to/cache:/cache
      - /path/to/media/movies:/media/movies
      - /path/to/media/music:/media/music
      - /path/to/media/photos:/media/photos
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai  # 设置时区

启动服务：

bash
docker-compose up -d

环境变量配置

Jellyfin容器支持以下环境变量进行配置：

• JELLYFIN_NOWEBCONTENT：设置为true时不托管Web客户端（用于单独托管Web客户端的场景）
• TZ：设置时区，如Asia/Shanghai
• JELLYFIN_PublishedServerUrl：指定服务器对外访问的URL（用于远程访问配置）

示例：

bash
docker run -d \
  --name jellyfin \
  -p 8096:8096 \
  -v /path/to/config:/config \
  -v /path/to/media:/media \
  -e TZ=Asia/Shanghai \
  -e JELLYFIN_NOWEBCONTENT=true \
  docker.xuanyuan.run/jellyfin/jellyfin

访问与初始设置

容器启动后，通过浏览器访问 http://<服务器IP>:8096 进入Jellyfin初始设置向导，完成以下步骤：

1. 创建管理员账户
2. 添加媒体库（电影、音乐、照片等）
3. 配置媒体元数据获取方式
4. 设置网络和远程访问选项

高级配置

单独托管Web客户端

若需单独托管Web客户端（如开发场景），可设置JELLYFIN_NOWEBCONTENT=true，此时服务器不托管Web内容，需通过独立的Web服务器（如Nginx）或Webpack开发服务器托管Jellyfin Web客户端。

硬件加速转码

为提升转码性能，可启用硬件加速（需宿主机支持），通过挂载设备和配置环境变量实现，例如：

bash
docker run -d \
  --name jellyfin \
  -p 8096:8096 \
  -v /path/to/config:/config \
  -v /path/to/media:/media \
  --device=/dev/dri/renderD128:/dev/dri/renderD128 \  # Intel核显硬件加速
  jellyfin/jellyfin

在Jellyfin管理界面的“服务器>播放”设置中，选择对应的硬件加速选项（如Intel Quick Sync）。

相关资源

• 官方文档：https://docs.jellyfin.org
• GitHub仓库：https://github.com/jellyfin/jellyfin
• 下载页面：https://jellyfin.org/downloads
• 社区支持：https://docs.jellyfin.org/general/getting-help.html