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

## Source File
- [[raw/Home Office/用Docker安装Jellyfin.md]]

## 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 一键部署
- [[只读挂载]]：保护源文件不被容器内进程意外修改
- [[Plex]]：Jellyfin 是 Plex 的开源分支，功能高度同构

## Key Entities
- [[Jellyfin]]：开源媒体服务器，Plex 的自由软件替代品
- [[Synology NAS]]：群晖 NAS，Docker 宿主机，存储媒体文件
- [[nyanmisaka/jellyfin]]：优化过的 Jellyfin 第三方镜像，内置转码支持

## Connections
- [[Jellyfin]] ← runs_on ← [[Synology NAS]]
- [[Jellyfin]] ← transcodes_with ← Intel QuickSync (via /dev/dri)
- [[Jellyfin]] ← serves_media ← /volume2/movie + /volume1/TV shows
- [[家庭网络环境概览_2026-04-03]] ← 暴露公网访问 ← jellyfin.ishenwei.online:18096

## Jellyfin Docker Compose 核心配置

```yaml
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
- 与 [[Synology NAS + Xiaoya Alist + CloudDrvie2+ Plex to Build Media Platform]]：
  - 冲突点：Plex vs Jellyfin 作为媒体服务器的选择
  - 当前观点：Jellyfin 开源自托管，完全免费
  - 对方观点：Plex 有更好的商业生态和客户端支持