Jellyfin 镜像文档

镜像概述

Jellyfin 是一款开源、跨平台的媒体服务器软件，旨在帮助用户构建个人或家庭媒体中心。通过该镜像，用户可快速部署媒体服务器，实现对本地媒体文件（视频、音频、图片）的集中管理、分类整理，并支持向多种设备（如智能电视、手机、电脑、平板等）流式传输媒体内容，无需依赖第三方服务。

核心功能和特性

• 媒体库管理：自动识别并分类视频（电影、剧集）、音频（音乐、播客）和图片，支持元数据抓取（封面、简介、演员信息等）。
• 跨平台流式传输：支持 DLNA、Chromecast 及原生客户端（Windows、macOS、Linux、Android、iOS 等），实现多设备无缝访问。
• 实时媒体转码：根据客户端设备性能自动调整媒体编码格式和质量，确保流畅播放，支持硬件加速转码（如 Intel Quick Sync、NVIDIA NVENC）。
• 用户与权限管理：支持多用户创建，可自定义用户权限（如媒体库访问范围、播放权限），实现个性化媒体体验。
• 插件扩展：通过插件系统扩展功能，如字幕下载、 trakt.tv 集成、主题定制等。
• 直播电视支持：兼容 TV 调谐器，可观看和录制直播电视节目（需额外配置）。

使用场景和适用范围

• 家庭媒体中心：集中管理家庭影音资源，实现多设备共享播放。
• 个人媒体服务器：整理个人收藏的电影、音乐，随时随地通过网络访问。
• 小型组织媒体共享：如工作室、社团共享培训视频、资料片等。
• 开发者测试环境：快速部署媒体服务进行应用兼容性测试。

使用方法和配置说明

基本使用（Docker Run 命令）

通过以下命令快速启动 Jellyfin 容器：

docker run -d \
  --name jellyfin \
  --net=host \  # 推荐使用 host 网络以支持 DLNA/UPnP，或手动映射端口
  -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 \         # 时区设置
  --restart unless-stopped \
  codeberg.org/egirl/jellyfin

注意：若不使用 --net=host，需手动映射端口（如 -p 8096:8096 用于 Web 界面，-p 8920:8920 用于 HTTPS，-p 7359:7359/udp 用于 DLNA 发现等）。

Docker Compose 配置示例

创建 docker-compose.yml 文件，简化部署和管理：

version: '3.8'

services:
  jellyfin:
    image: codeberg.org/egirl/jellyfin
    container_name: jellyfin
    network_mode: host  # 或替换为 ports 配置
    volumes:
      - /path/to/config:/config
      - /path/to/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
      - JELLYFIN_LOG_LEVEL=info  # 日志级别：trace, debug, info, warn, error, fatal
    restart: unless-stopped
    # 若启用硬件转码，添加设备映射（如 NVIDIA GPU）：
    # deploy:
    #   resources:
    #     reservations:
    #       devices:
    #         - driver: nvidia
    #           count: 1
    #           capabilities: [gpu]

核心配置说明

1. 卷挂载（Volumes）

2. 环境变量（Environment Variables）

3. 网络配置

• Host 网络：推荐使用 --net=host（或 network_mode: host），可自动映射所有必要端口，确保 DLNA、Chromecast 等功能正常。
• 端口映射（非 host 网络时）：

  -p 8096:8096  # Web 界面及 HTTP 流式传输
  -p 8920:8920  # HTTPS 访问（需配置 SSL 证书）
  -p 7359:7359/udp  # DLNA 发现
  -p 1900:1900/udp  # SSDP 服务
  

初始化设置

容器启动后，通过 http://<服务器IP>:8096 访问 Web 界面，按引导完成：

1. 创建管理员账户
2. 添加媒体库（选择 /media 下的子目录，如电影、音乐）
3. 配置媒体库元数据抓取（选择语言、数据源等）
4. 完成设置后即可开始使用。

注意事项

• 硬件转码：若需启用硬件转码（如 NVIDIA GPU），需确保主机已安装对应驱动，并在容器中映射 GPU 设备（参考 docker-compose 示例中的部署配置）。
• 媒体文件权限：确保挂载的 /media 目录及文件对容器内用户（PUID/PGID）有读取权限。
• 备份：定期备份 /config 目录，避免配置和媒体库元数据丢失。