---
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 配置