79 lines
3.3 KiB
Markdown
79 lines
3.3 KiB
Markdown
---
|
||
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 有更好的商业生态和客户端支持
|