Jellyfin 实战部署：从 0 到可用的家庭影音中心（Docker 版）篇1

折腾家庭影音，最怕两件事：一是平台锁死，二是后期难迁移。想要“可控、可迁移、无订阅束缚”，Jellyfin 是一条很稳的路线。本文不讲空话，直接给可复现流程：Docker Compose + 媒体库规范 + 升级回滚策略。按文中步骤走，30 分钟可跑通。

一、为什么选 Jellyfin

Jellyfin 的核心价值有三点：

1. 开源免费：没有会员墙，不用担心功能后续被阉割。

2. 数据可控：媒体库、配置、元数据都在自己手里，迁移成本低。

3. 生态够用：网页、手机、电视端都有客户端，覆盖家庭使用场景。

一句话总结：Jellyfin 不是“傻瓜一步到位”，但它是“长期主义最省心”。

二、部署前准备

建议环境：

- 系统：Ubuntu 22.04+或者群晖，或者任意一台支持docker的主机

- 部署：Docker + Docker Compose

- 媒体盘：挂载到宿主机固定目录

- 时区：Asia/Shanghai

- 端口：先查占用再定（默认 8096）

目录建议：

bash

mkdir -p /data/jellyfin/config

mkdir -p /data/jellyfin/cache

mkdir -p /data/media

建议先只做内网可用，不要第一步就上反代和外网访问。先跑稳，再增强。

三、Docker Compose 一把起

新建 docker-compose.yml：如果是群晖，自己修改映射的文件夹对应群晖的目录和路径

yaml

services:

jellyfin:

image: jellyfin/jellyfin:10.10.7

container_name: jellyfin

ports:

- "8096:8096"

environment:

- TZ=Asia/Shanghai

volumes:

- /data/jellyfin/config:/config

- /data/jellyfin/cache:/cache

- /data/media:/media:ro

- /etc/localtime:/etc/localtime:ro

- /etc/timezone:/etc/timezone:ro

restart: unless-stopped

启动：

bash

docker compose up -d

docker ps | grep jellyfin

访问：

text

http://你的主机IP:8096

首次向导完成管理员账号、语言、媒体库类型即可。

四、媒体库结构：体验好不好就看这里

很多人说 Jellyfin“刮削不准”，根因往往是目录和命名不规范。建议：

- 电影：`/data/media/movies/电影名 (年份)/影片文件`

- 剧集：`/data/media/tv/剧名/Season 01/剧集文件`

- 动漫：独立库，避免和普通剧集混淆

字幕建议：

- 字幕文件与视频同名

- 放在同目录

- 优先 UTF-8 编码 .srt

命名越规范，刮削命中率越高，后续维护越轻。

五、转码与硬解：流畅度的关键

Jellyfin 是否“卡顿”，关键不在 CPU 型号，而在转码策略：

1. 能直播放就直播放（最省资源）

2. 不兼容编码才转码

3. 有核显/独显时再启硬件加速（QSV/NVENC）

建议顺序：先验证不启硬解是否稳定，再开启硬解。别反过来，否则问题很难定位。

CPU/GPU 要求推荐：

1) 最低可用（仅 1-2 路、尽量直播放）

CPU：4核（如 N100 / 老 i5 也能跑）

GPU：可无独显（纯 CPU 软解可用，但转码能力弱）

适合：家里 1-2 人同时看，主要 1080p

2) 推荐档（家庭常用，体验稳）

CPU：6核及以上（现代桌面/移动 CPU）

GPU：有核显优先（Intel Quick Sync / AMD iGPU）

适合：2-4 路并发，偶发转码，4K→1080p 更稳

3) 高并发档（多终端+高码率）

CPU：8核及以上

GPU：建议独显硬解（NVIDIA NVENC 更成熟）

适合：多路同时转码、远程访问较多

关键原则（比参数更重要）

• 能直播放就别转码（最省硬件）

• 有核显就先用核显硬解，不必急着上独显

• 真正吃资源的是“多路同时转码”，不是单人看片

六、稳定运行的三板斧

1）权限

容器能读到媒体目录是底线。如果“库扫不到文件”，先查宿主机目录权限。

2）备份

优先备份 config，因为它包含账号、库配置、插件状态。媒体本体可重建，配置最值钱。

3）升级

不要盲追 latest，推荐流程：

1. 看变更说明

2. 备份配置

3. 拉新镜像重启

4. 验证播放再清理旧镜像

七、五个常见坑（直接避）

1. 端口冲突：8096 被占，服务启动失败

2. 挂载路径写错：容器里目录存在但没数据

3. 权限不足：媒体可见但无法读取

4. 初期过度复杂：一上来就外网+HTTPS，排障倍增

5. 命名混乱：刮削失败、封面错配

八、谁最适合上 Jellyfin

如果你满足以下三条，Jellyfin 就是正解：

- 想长期沉淀家庭媒体库

- 不想被平台会员机制绑定

它不是“最省事”的方案，但通常是“长期总成本最低”的方案。

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～