## 前言
飞牛OS上用Docker部署Jellyfin，可以把NAS变成家庭影院——手机、电视、平板随时看NAS里的电影电视剧，自动刮削海报和简介！本教程零基础手把手教你搞定。
## 一、Jellyfin是什么？
Jellyfin是开源免费的媒体服务器：
– 自动整理电影/电视剧/音乐
– 自动下载海报和简介
– 支持转码，各种设备都能播放
– 完全免费，没有付费功能限制
– 支持硬件加速解码
## 二、前期准备
### 2.1 确认飞牛OS Docker已安装
飞牛OS后台 → Docker管理器 → 确认Docker正常运行
### 2.2 创建目录
SSH连接NAS，创建Jellyfin需要的目录：
mkdir -p /vol1/docker/jellyfin/config
mkdir -p /vol1/docker/jellyfin/cache
mkdir -p /vol1/docker/jellyfin/media
把你的视频文件放到 /vol1/docker/jellyfin/media 目录下。
## 三、Docker Compose部署
创建 docker-compose.yml 文件：
version: ‘3.8’
services:
jellyfin:
image: jellyfin/jellyfin:latest
container_name: jellyfin
environment:
– PUID=0
– PGID=0
– TZ=Asia/Shanghai
volumes:
– /vol1/docker/jellyfin/config:/config
– /vol1/docker/jellyfin/cache:/cache
– /vol1/docker/jellyfin/media:/media
ports:
– 8096:8096
– 8920:8920
devices:
– /dev/dri:/dev/dri
restart: unless-stopped
启动：docker compose up -d
## 四、初始化Jellyfin
1. 浏览器访问 http://NAS的IP:8096
2. 选择语言（中文）
3. 创建管理员账号
4. 添加媒体库 → 选择类型（电影/电视剧/音乐）→ 路径选 /media
5. 完成向导
## 五、开启硬件加速
如果你的NAS有Intel核显，可以开启硬解大幅降低CPU占用：
1. 后台 → 播放 → 硬件加速
2. 选择 Video Acceleration API (VAAPI)
3. VAAPI设备填 /dev/dri/renderD128
4. 勾选支持的编码格式
5. 保存
## 六、中文字体修复
Jellyfin默认缺少中文字体，可能导致字幕和界面显示方块：
1. 下载中文字体（如思源黑体）
2. 拷贝字体文件到 /vol1/docker/jellyfin/config/fonts/
3. 后台 → 播放 → 启用备用字体
## 七、常见报错解决
| 报错 | 原因 | 解决方案 |
|——|——|———|
| 媒体库看不到文件 | 映射路径错误 | 检查volumes映射和PUID/PGID |
| 硬解不生效 | 未添加devices | 添加 devices: /dev/dri:/dev/dri |
| 镜像拉取失败 | 国内网络 | 配置阿里云镜像加速器 |
| 字幕乱码/方块 | 缺中文字体 | 拷贝字体到config/fonts |
| 转码CPU 100% | 未开硬解 | 开启VAAPI硬件加速 |
| 8096端口打不开 | 防火墙未放行 | 开放8096端口 |
## 八、避坑总结
1. PUID和PGID设为0（root），避免权限问题
2. Intel核显一定要开VAAPI硬解，CPU占用从100%降到10%
3. 中文字体问题提前处理
4. media目录映射一定要对，不然看不到视频
5. 电视剧按”季/集”目录结构存放，刮削效果最好
本教程由技术保姆网原创，转载请注明出处。