Files
nexus/wiki/sources/用docker安装jellyfin.md

49 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: "用Docker安装Jellyfin"
type: source
tags: [docker, jellyfin, movie, nas, synology, tv-show]
date: 2026-04-14
---
## Source File
- [[raw/Home Office/用Docker安装Jellyfin.md]]
## Summary (用中文描述)
- 核心主题:通过 Docker Compose 在群晖 NAS 上部署 Jellyfin 视频媒体服务器,实现家庭媒体中心
- 问题域家庭影院、个人媒体库、NAS 多媒体服务
- 方法/机制:使用 nyanmisaka/jellyfin 镜像(预装硬件转码优化),通过 Docker Compose YAML 配置服务,启用 Intel QuickSync 硬件加速转码(/dev/dri 设备直通),配置多目录媒体挂载、群晖 UID/GID 用户权限、自定义字体、时区和外网发布 URL
- 结论/价值:构建完整的"Transmission 下载 → Jellyfin 播放"家庭媒体工作流,支持视频转码以适配不同客户端
## Key Claims (用中文描述)
- nyanmisaka/jellyfin 镜像通过预装 FFmpeg 和硬件转码依赖,提供开箱即用的 Intel QuickSync 加速能力
- 群晖 NAS 使用 `user: "1026:100"` 固定 UID:GID可避免容器内文件权限问题
- `/dev/dri` 设备直通使容器内 Jellyfin 可调用宿主机的 GPU 进行硬件视频转码
- Jellyfin 默认端口 8096UDP 端口 7359 用于自动发现
## Key Quotes
> "核心优化:挂载硬件渲染设备以实现 Intel QuickSync 转码" — 硬件加速转码是 Jellyfin 在 NAS 上的性能关键
## Key Concepts
- [[硬件转码]]:通过 Intel QuickSync / NVIDIA GPU / VA-API 等硬件加速视频编解码,相比软件转码大幅降低 CPU 占用
- [[媒体服务器]]:提供视频/音乐流媒体播放服务的自托管应用Jellyfin 属于此类
- [[Docker 用户权限映射]]:通过 PUID/PGID 或 user 字段将容器内用户映射到宿主机特定用户,解决文件读写权限问题
- [[设备直通]]:通过 Docker devices 参数将宿主机设备(如 GPU、硬件编码器映射到容器内使用
## Key Entities
- [[Jellyfin]]:开源视频媒体服务器,本文部署的目标服务,提供网页端播放和管理界面
- [[nyanmisaka/jellyfin]]:社区维护的 Jellyfin Docker 镜像,预装优化版 FFmpeg 和硬件转码支持
- [[群晖 NAS]]Synology NASNAS 设备类型,本文 Jellyfin 的宿主机,提供 /volume1/docker 存储路径
- [[Intel QuickSync]]Intel CPU 集成视频编码/解码硬件单元,通过 /dev/dri 接口访问
- [[LinuxServer.io]]:开源 Docker 镜像维护组织Jellyfin 官方镜像由其维护nyanmisaka 是社区优化分支
## Connections
- [[Transmission]] ← 下载端 ← [[Jellyfin]](播放端)— "下载→整理→播放" 家庭媒体工作流
- [[Navidrome]] ← 对标竞品 ← [[Jellyfin]] — Navidrome 服务音乐Jellyfin 服务视频
- [[用docker安装transmission]] ← 共用宿主机 ← [[用docker安装jellyfin]] — 共用 Docker 环境和 NAS 存储
- [[群晖 NAS]] ← 宿主机 ← [[用docker安装jellyfin]] — NAS 提供 Docker 环境和存储卷
- [[Intel QuickSync]] ← 依赖 ← [[Jellyfin]] — QuickSync 提供硬件转码加速
- [[Docker卷]] ← 数据存储 ← [[Jellyfin]] — config 和 cache 目录持久化
## Contradictions
- 无已知冲突