Files
nexus/wiki/sources/用Docker安装Jellyfin.md

3.3 KiB
Raw Blame History

title, type, tags, date
title type tags date
用Docker安装Jellyfin source
docker
jellyfin
media-server
synology
nas
2026-04-03

Source File

Summary

  • 核心主题Synology NAS Docker 部署 Jellyfin 开源媒体服务器
  • 问题域:自托管家庭媒体库,支撑 Plex 对抗的商业闭源方案
  • 方法/机制nyanmisaka/jellyfin 镜像 + Intel QuickSync 硬件转码 + 群晖 UID/GID 固定 + 只读媒体卷保护
  • 结论/价值:完整的 Jellyfin Docker Compose 配置,含硬件转码、环境变量、字体挂载、端口和重启策略

Key Claims

  • nyanmisaka/jellyfin 镜像提供优化的 Jellyfin 构建,修复官方镜像转码兼容性问题
  • 通过 --devices /dev/dri:/dev/dri 挂载 Intel GPU实现硬件 QuickSync 转码,降低 CPU 负载
  • 容器使用 user: "1026:100" 固定为群晖默认用户,避免权限问题
  • /volume1/docker/jellyfin/fonts 目录以 :ro 只读挂载,防止字体被容器修改
  • JELLYFIN_PublishedServerUrl 环境变量设置公网访问地址,供外部发现服务
  • restart: unless-stopped 保证容器崩溃后自动重启

Key Quotes

"群晖建议使用具体的 UID:GID" — Docker 部署最佳实践 "核心优化:挂载硬件渲染设备以实现 Intel QuickSync 转码" — 性能优化关键

Key Concepts

  • 硬件转码Intel QuickSync 利用 GPU 加速视频格式转换,减轻 CPU 负担
  • 媒体刮削Jellyfin 自动从 TMDB/TVDB 等源获取元数据(标题/封面/简介)
  • Docker容器化隔离运行环境影响docker-compose 一键部署
  • 只读挂载:保护源文件不被容器内进程意外修改
  • PlexJellyfin 是 Plex 的开源分支,功能高度同构

Key Entities

  • Jellyfin开源媒体服务器Plex 的自由软件替代品
  • Synology NAS:群晖 NASDocker 宿主机,存储媒体文件
  • nyanmisaka/jellyfin:优化过的 Jellyfin 第三方镜像,内置转码支持

Connections

Jellyfin Docker Compose 核心配置

services:
  jellyfin:
    image: nyanmisaka/jellyfin:latest
    container_name: jellyfin
    user: "1026:100"
    ports:
      - 8096:8096/tcp
      - 7359:7359/udp  # 客户端自动发现
    volumes:
      - /volume1/docker/jellyfin/config:/config
      - /volume1/docker/jellyfin/cache:/cache
      - /volume2/movie:/media
      - /volume1/TV shows:/media2
      - /volume1/docker/jellyfin/fonts:/usr/local/share/fonts/custom:ro
    environment:
      - JELLYFIN_PublishedServerUrl=http://jellyfin.ishenwei.online
      - TZ=Asia/Shanghai
    devices:
      - /dev/dri:/dev/dri  # Intel GPU 硬件转码
    restart: unless-stopped
    extra_hosts:
      - host.docker.internal:host-gateway

Contradictions