77 lines
2.8 KiB
Markdown
77 lines
2.8 KiB
Markdown
---
|
||
title: "Jellyfin"
|
||
type: entity
|
||
tags: [video, media-server, self-hosted, open-source, docker]
|
||
date: 2026-04-14
|
||
---
|
||
|
||
# Jellyfin
|
||
|
||
开源视频媒体服务器，提供网页端流媒体播放、管理界面和转码能力。
|
||
|
||
## Aliases
|
||
- Jellyfin Media Server
|
||
- Jellyfin Server
|
||
|
||
## Type
|
||
开源自托管视频流媒体服务器（Emby 分支）
|
||
|
||
## Core Functionality
|
||
- 视频播放与管理，支持电影、电视剧、体育节目等多种媒体类型
|
||
- 硬件加速视频转码（Intel QuickSync / NVIDIA GPU / VA-API / AMD VCE）
|
||
- 元数据刮削（TMDB/TheTVDB 等）
|
||
- 多用户支持与播放进度追踪
|
||
- DLNA / Chromecast / Apple TV / Roku 等设备投射
|
||
- Web UI + 官方客户端（Android / iOS / TV 版）
|
||
|
||
## Key Images
|
||
| 镜像 | 维护者 | 特点 |
|
||
|------|--------|------|
|
||
| linuxserver/jellyfin | LinuxServer.io | 官方稳定版 |
|
||
| nyanmisaka/jellyfin | 社区维护 | 预装优化 FFmpeg，硬件转码开箱即用 |
|
||
|
||
## Docker 配置关键参数（nyanmisaka 镜像）
|
||
```yaml
|
||
services:
|
||
jellyfin:
|
||
image: nyanmisaka/jellyfin:latest
|
||
user: "1026:100" # 群晖 UID:GID
|
||
ports:
|
||
- 8096:8096/tcp # Web UI
|
||
- 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 QuickSync 硬件转码
|
||
restart: unless-stopped
|
||
extra_hosts:
|
||
- 'host.docker.internal:host-gateway'
|
||
```
|
||
|
||
## Hardware Transcoding
|
||
- **Intel QuickSync**：通过 `/dev/dri` 设备直通，nyanmisaka 镜像预装支持
|
||
- **NVIDIA GPU**：需 nvidia-container-toolkit
|
||
- **软件转码**：ffmpeg fallback，适合低功耗设备
|
||
|
||
## 性能考量
|
||
- 媒体转码建议内存 2-4GB
|
||
- 群晖 NAS 上优先使用 QuickSync / VA-API 硬件转码以降低 CPU 占用
|
||
- cache 目录建议 SSD 以提升元数据和缩略图读写性能
|
||
|
||
## Connections
|
||
- [[Transmission]] ← 下载端 → [[Jellyfin]]（播放端）— "下载→整理→播放" 家庭媒体工作流
|
||
- [[Navidrome]] ← 对标竞品 → [[Jellyfin]] — Navidrome 服务音乐，Jellyfin 服务视频
|
||
- [[群晖 NAS]] ← 宿主机 → [[Jellyfin]] — NAS 提供存储和 Docker 运行环境
|
||
- [[nyanmisaka/jellyfin]] ← 优化镜像 → [[Jellyfin]] — 预装硬件转码支持的社区镜像
|
||
- [[LinuxServer.io]] ← 官方镜像 → [[Jellyfin]] — 稳定版官方镜像维护组织
|
||
|
||
## Sources
|
||
- [[用docker安装jellyfin]] — 在群晖 NAS 上部署 Jellyfin 的完整 Docker Compose 配置
|