artiume/jellyfin

Jellyfin Docker镜像文档

镜像概述

Jellyfin是一款免费开源的媒体系统，旨在让用户完全控制媒体内容的管理与流媒体传输。作为Emby和Plex等专有软件的替代方案，它允许从专用服务器向多终端设备（通过各类客户端应用）提供媒体服务。Jellyfin源自Emby 3.5.2版本，后迁移至.NET Core框架，实现了全平台支持。该项目无附加条件、无 premium 许可或功能限制，由社区驱动开发，致力于构建更优的媒体解决方案。

核心功能与特性

• 免费开源：基于GPL 2.0许可，无隐藏费用或功能限制
• 跨平台支持：基于.NET Core框架，可在Windows、Linux、macOS等多种操作系统运行
• 多客户端兼容：支持通过各类设备（如手机、平板、智能电视、电脑）的客户端访问媒体
• 媒体管理：自动组织和元数据检索，支持电影、电视节目、音乐、照片等多种媒体类型
• 流媒体传输：支持自适应比特率 streaming，适配不同网络环境
• 用户权限管理：可创建多用户账户，设置不同媒体访问权限
• 社区驱动：活跃的开发社区，持续更新功能与修复问题

使用场景

• 家庭媒体服务器：搭建家庭共享媒体库，供家庭成员在不同设备上访问
• 个人媒体库管理：集中管理个人收藏的电影、音乐、照片等媒体内容
• 多设备流媒体服务：在电视、手机、平板等设备上无缝播放媒体内容
• 替代专有媒体服务：作为Emby或Plex的免费开源替代方案，降低使用成本

使用方法与配置说明

基本Docker运行命令

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

Docker Compose配置示例

yaml
version: '3.5'
services:
  jellyfin:
    image: docker.xuanyuan.run/jellyfin/jellyfin
    container_name: jellyfin
    user: 1000:1000  # 根据实际用户ID和组ID调整
    volumes:
      - /path/to/config:/config
      - /path/to/cache:/cache
      - /path/to/media:/media
      - /path/to/transcode:/transcode  # 可选，用于转码缓存
    ports:
      - "8096:8096"  # HTTP端口
      - "8920:8920"  # HTTPS端口
      - "7359:7359/udp"  # 自动发现端口
      - "1900:1900/udp"  # DLNA端口
    restart: unless-stopped
    environment:
      - JELLYFIN_PublishedServerUrl=http://your-server-ip:8096  # 服务器对外访问URL

参数说明

数据卷（Volumes）

• /config：存储Jellyfin配置文件、数据库和元数据
• /media：媒体文件存储目录（电影、音乐等）
• /cache：缓存目录，用于存储临时文件和转码内容
• /transcode（可选）：专用转码缓存目录，建议使用高速存储

端口映射（Ports）

• 8096：HTTP访问端口，用于Web界面和客户端连接
• 8920：HTTPS访问端口（需配置SSL证书）
• 7359/udp：客户端自动发现服务端口
• 1900/udp：DLNA服务端口

环境变量（Environment Variables）

• JELLYFIN_PublishedServerUrl：服务器对外访问的URL，用于远程访问和客户端连接
• JELLYFIN_FFmpegPath：自定义FFmpeg路径（如使用外部FFmpeg）
• PUID/PGID：指定运行容器的用户ID和组ID，避免权限问题

首次使用步骤

1. 启动容器后，通过http://服务器IP:8096访问Jellyfin Web界面
2. 按照向导完成初始设置：创建管理员账户、添加媒体库、配置网络等
3. 安装对应设备的Jellyfin客户端（如手机App、智能电视应用等）
4. 使用管理员账户登录客户端，开始访问媒体内容

相关资源

• 官方文档：https://docs.jellyfin.org
• GitHub仓库：https://github.com/jellyfin/jellyfin
• Docker Hub：https://hub.docker.com/r/jellyfin/jellyfin
• 社区支持：[***]