这是「Docker 好项目」系列的第 17 期。这个系列写到今天,照片(第 4 期 Immich)、音乐(第 8 期 Navidrome)都搬回来了,唯独家里的电影和剧集还悬着。市面上能管影视库的自托管方案不少,但要么收费(Plex 部分功能要买 Pass),要么闭源(Emby),要么对硬件要求苛刻。Jellyfin 是这三条路之外的那条:完全免费、完全开源、数据全在自己机器上。它也是这个系列里名气最大的一个项目——58k stars,几乎是前 16 期所有项目里体量最大的。

痛点开场
先看"把电影交给别人管"的几种典型死法:
- 网盘存电影。115、夸克、阿里云盘,存片方便,但"在线播放"的画质由不得你——转码、限速、会员分级,一套组合拳下来 4K 片源只剩 720p 观感。而且哪天"违规内容清理",整个收藏说没就没
- Plex / Emby 闭源。这两个确实是好产品,但核心代码不开放。Plex 的硬件转码要买 Plex Pass,Emby 的高级功能要 Emby Premiere,而且都要求你注册它们的账号体系。哪天改服务条款,你只能接受
- NAS 自带的影视中心。群晖 Video Station、威联通 Video Station 功能都停在"能播"这个层面:刮削粗糙、不支持外挂字幕搜索、手机端要单独买
- 各设备各播各的。电视上一个播放器、手机上一个播放器、平板又一个,播放进度不同步,看了一半的电影换个设备就找不到了
Jellyfin 的解法是把"媒体服务器"这件事整个搬回自己机器:你给它一个文件夹,它把里面所有电影、剧集识别出来、刮削好海报和简介,然后给全屋所有设备一个统一的入口——电视、手机、平板、浏览器,播放进度实时同步。它源自 Emby 3.5.2 的最后一个开源版本,社区在 2018 年 fork 出来后独立发展到今天,没有商业公司,没有付费墙。

Jellyfin 的网页端首页:媒体库、继续观看、最新添加一目了然
能力边界
能干什么
- 电影 / 剧集 / 音乐 / 有声书 / 短视频库管理:自动刮削海报、简介、演员表,支持 TMDb、TVDb 等元数据源
- 全端播放:网页、Android、Android TV、iOS、tvOS、Kodi 插件、Roku、Fire TV……官方客户端列表很长,还有第三方客户端(Infuse、Finamp、Findroid)
- 实时转码:客户端解不动的格式(比如 4K HEVC 10bit 推给老电视),服务器端实时转码;支持硬解(Intel QSV / NVIDIA NVENC / AMD VAAPI / Rockchip)
- 多用户 + 权限:每个家庭成员独立账号,播放进度、观看历史各自独立;能按用户限制可看的媒体库、限速、限制同时播放数
- 字幕:外挂字幕自动加载、在线下载(OpenSubtitles 插件)、内嵌字幕烧录;官方镜像内置了中日韩全套字体,烧录中文字幕不会变方块(这是很多人从其他方案换过来的直接原因)
- 继续观看:跨设备同步播放进度,手机看一半回家电继续
- 直播电视 + 录制:配合 IPTV 源或 HDHomeRun 硬件可以看直播、定时录像(插件形式)
- 离线可用:除了刮削元数据需要联网,核心功能完全不需要外网
- API:REST API 全开放,能写脚本批量管理
不干什么
- 不做内容分发。它不是网盘,没有分享链接、没有外链播放。想"发个链接给朋友在线看",它不干这个
- 不是下载器。Jellyfin 管的是"已经有了的文件",下载这件事(BT、订阅、自动追新番)是 *arr 全家桶(Sonarr/Radarr)的活,两者通常配合使用但互不隶属
- 转码吃资源。软转 4K HEVC 对 CPU 是实打实的考验,2 核 2G 的机器转不动。要么直播直出(Direct Play),要么有核显/独显做硬解。这不是缺陷,是物理规律
- iOS 客户端部分功能要钱。Jellyfin 服务器本身完全免费,但官方 iOS App 的高级功能、以及 Infuse 这类第三方客户端是收费的。这不是 Jellyfin 收钱,是客户端生态
- 没有内置的"追新提醒"。新剧集出了不会主动告诉你,这个活交给第 9 期 changedetection.io 或 *arr 系列
- 元数据刮削依赖外网。TMDb 在国内直连不稳定,刮削失败或海报出不来是这个项目最常见的"新手问题",解法见踩坑清单
一句话:Jellyfin 是"给已有片源建一个全屋共享的影视库",不是"帮你搞片源"。片源自己负责,剩下的它全包。
部署前准备
- 一台能跑 Docker 的机器。官方镜像支持 amd64 / arm64 / armhf。纯播放不做转码的话,2 核 2G 够用;要转码,建议 4 核起步 + 有核显的 CPU(Intel 6 代以上)或独立显卡
- 一个媒体目录。把电影、剧集按文件夹组织好,比如
/media/movies、/media/tv。Jellyfin 不需要你改文件名——它对常见的"电影名 (年份).mkv"、"剧名 S01E01.mkv"识别率很高 - (可选)一个域名。只在局域网看的话不用;想在外面看,配个反向代理上 HTTPS 更稳(见反向代理章节)
- 镜像源:Docker Hub
jellyfin/jellyfin,同时发布在ghcr.io/jellyfin/jellyfin(国内拉不动可以换)
关于 tag,这期我实测了一遍(v12.1,2026-09-15 发布):
| tag | 结果 |
|---|---|
12 |
200(digest sha256:326be101…) |
12.1 |
200,与 12 digest 完全相同 |
latest |
200,与 12、12.1 digest 完全相同 |
12.1.0 |
404,不存在 |
10.11.0 |
200(对照组,确认探测通道正常) |
第 10 期 Gitea、第 13 期 ntfy、第 14 期 Paperless-ngx 都属于"滚动次版本 tag"这一类,Jellyfin 也是。推荐钉 :12.1——跟随 12.1.x 的 bugfix 版本,但不会被 13.0 的大版本变动波及。
这里有个值得注意的细节:12.x 起官方不再发三位版本号的 tag。10.x 时代 10.11.0 是存在的(我对照测试过,返回 200),但 12.1 之后 12.1.0 直接 404。官方把版本号从三段改成两段了(12.1 就是一个完整版本号,没有补丁位),以后写 12.1.x 这种写法都是错的。这也是为什么这期我把 tag 表里加了个 10.11.0 做对照组——不排除有教程还在教人写 12.1.0,照抄必挂。
docker run 一行版
mkdir -p /opt/jellyfin/{config,cache,media}
docker run -d \
--name jellyfin \
-p 8096:8096 \
-p 7359:7359/udp \
-v /opt/jellyfin/config:/config \
-v /opt/jellyfin/cache:/cache \
-v /opt/jellyfin/media:/media:ro \
--restart unless-stopped \
jellyfin/jellyfin:12.1
装完浏览器开 http://<服务器IP>:8096,会进入首次设置向导(见下文"首次访问")。
几个必须知道的点:
-v …:/config是唯一必须持久化的卷。数据库(jellyfin.db)、配置 XML、日志全在里面。这个目录丢了 = 整个媒体库的元数据、用户、观看记录全没了,虽然媒体文件本身还在别的盘/media:ro加了只读。Jellyfin 理论上只需要读媒体文件,给它只读权限能防止误写。唯一例外:如果你想让 Jellyfin 自动删除".nfo"同目录的元数据文件,才需要读写7359/udp是客户端自动发现。局域网里的手机/电视 App 打开后能自动列出服务器,全靠这个 UDP 广播。不映射也能手动填 IP 连上,映射了体验更好- 镜像自带
HEALTHCHECK(我拉了镜像 config 确认,Healthcheck字段不是 null):curl --noproxy 'localhost' -Lk -fsS "${HEALTHCHECK_URL}",其中HEALTHCHECK_URL=http://localhost:8096/health,每 30 秒一次,启动宽限 10 秒。不需要自己加 - 容器以 root 运行。镜像 config 里
User字段是null,Dockerfile 里也没有USER指令。但和第 16 期 Actual Budget 不同的是——官方明确支持user:指令降权:Dockerfile 里把/config和/cache都chmod 777了,任何 UID 都能写。想跑非 root,加user: "1000:1000"即可,文件权限不会出问题
docker-compose 推荐版
services:
jellyfin:
image: jellyfin/jellyfin:12.1
container_name: jellyfin
restart: unless-stopped
ports:
- "8096:8096" # Web + API
- "7359:7359/udp" # 局域网自动发现
volumes:
- ./config:/config # 数据库 + 配置 + 日志,备份就备它
- ./cache:/cache # 转码临时文件,丢了没事
- ./media:/media:ro # 媒体文件,只读挂载
environment:
TZ: Asia/Shanghai
# JELLYFIN_PublishedServerUrl=http://jf.example.com # 反代后填,客户端自动发现时对外公布这个地址
# 硬解需要的话,取消注释(详见"硬件转码"章节)
# devices:
# - /dev/dri/renderD128:/dev/dri/renderD128
# group_add:
# - "122" # 宿主机 render 组的 GID,用 getent group render | cut -d: -f3 查
和官方文档的示例相比,我做了两处调整:
- 镜像钉了
:12.1,官方示例写的是jellyfin/jellyfin(等于 latest)。写 series 教程必须钉版本,不然半年后读者照着抄,跑出来的可能已经是一个行为变过的大版本 TZ显式指定了。不设的话容器内是 UTC,"最近添加"的时间、日志时间戳会和你差 8 小时,排查问题时很折磨
配置项逐项解释
Jellyfin 的环境变量分两类,机制完全不同,搞混了会白忙活:
第一类:容器内目录映射(Dockerfile 里写死的 ENV)
| 环境变量 | 默认值 | 说明 |
|---|---|---|
JELLYFIN_DATA_DIR |
/config |
数据库(jellyfin.db)所在目录 |
JELLYFIN_CONFIG_DIR |
/config/config |
各类 XML 配置(network.xml、encoding.xml 等) |
JELLYFIN_LOG_DIR |
/config/log |
日志目录,按天滚动 |
JELLYFIN_CACHE_DIR |
/cache |
转码临时文件、字体缓存 |
JELLYFIN_WEB_DIR |
/jellyfin/jellyfin-web |
网页端静态文件 |
JELLYFIN_FFMPEG |
/usr/lib/jellyfin-ffmpeg/ffmpeg |
转码用的 ffmpeg 路径 |
这些不用改。列出来是为了让你知道 /config 里面长什么样——比如日志在 /config/log,手动备份或排查问题时直接找那里。
第二类:通过 JELLYFIN_ 前缀透传给服务器的运行时配置
我在源码里核实过(Program.cs 第 388 行):Jellyfin 会调用 .AddEnvironmentVariables("JELLYFIN_"),也就是说任何以 JELLYFIN_ 开头的环境变量都会被当作配置读进去,配置键里的冒号(.NET 配置的分隔符)用双下划线 __ 代替:
| 环境变量 | 对应配置键 | 用途 |
|---|---|---|
JELLYFIN_PublishedServerUrl |
PublishedServerUrl |
自动发现时对外公布的地址,反代场景建议设 |
JELLYFIN_FFmpeg__probesize |
FFmpeg:probesize |
ffmpeg 探测缓冲大小,特殊片源时调 |
JELLYFIN_FFmpeg__novalidation |
FFmpeg:novalidation |
跳过 ffmpeg 启动校验(换第三方 ffmpeg 时用) |
JELLYFIN_kestrel__socket |
kestrel:socket |
让服务器监听 Unix socket 而不是 TCP(配合反代) |
JELLYFIN_hostwebclient |
hostwebclient |
设 false 时服务器不托管网页端(只用 App 连) |
为什么这套机制重要:如果你想给容器加启动参数(比如 --restore-archive),Docker 里要么改 command:,要么用环境变量。command: 会覆盖 ENTRYPOINT 后面的默认参数,而 Jellyfin 的 ENTRYPOINT 是 /jellyfin/jellyfin 本身,直接写 command: ["--restore-archive", "/config/data/backups/xxx.zip"] 是能工作的。但更常见的场景(比如设置 PublishedServerUrl)用环境变量更干净,不用动启动命令。
1Panel 面板怎么搞
1Panel 应用商店有 Jellyfin,直接搜就行。但有个坑要先说清楚:商店里的版本是 10.11.11,落后于官方的 12.1。我拉了 1Panel-dev/appstore 仓库的 apps/jellyfin/10.11.11/data.yml 和 docker-compose.yml 实测:
- 镜像
jellyfin/jellyfin:10.11.11 - 表单字段只有三个:网页端口(默认 8096)、媒体文件夹路径(
./data/media)、缓存文件夹路径(./data/cache) - compose 里没有
devices和group_add字段
这意味着两件事:
- 商店装的版本要手动升级才能到 12.1。10.11 到 12.0 之间有数据库迁移(见踩坑清单),升级前必须先备份。1Panel 里升级方式:进应用详情 → 修改 compose 文件里的镜像 tag → 重新部署
- 硬解要自己加配置。商店的 compose 没透传 GPU 设备,装完默认只能 CPU 软转。想用核显,进 1Panel 的"容器 → 编排"里编辑这个应用的
docker-compose.yml(路径/opt/1panel/apps/jellyfin/jellyfin/docker-compose.yml),把上面推荐版里注释掉的devices和group_add两段加进去,然后重建容器
建议的姿势:如果只是先试试,用商店装没问题;如果确定要长期用且要硬解,直接用容器 → 编排功能自己贴上面那份 compose,版本和配置都自己掌控。
顺带一提,1Panel 的应用编排默认会把应用挂到 1panel-network 这个外部网络。如果你想让 Jellyfin 和 NPM(第 2 期)在同一个 Docker 网络里互访,保持默认就好,反代时直接用容器名做主机名。
首次访问
浏览器打开 http://<服务器IP>:8096,会自动跳到设置向导,一共四步:
- 首选语言:选"简体中文"。界面、刮削优先级都会跟着变
- 创建管理员:用户名 + 密码。这个密码务必记住——Jellyfin 没有"忘记密码邮件"这回事,忘了只能进数据库重置或恢复备份
- 添加媒体库:选类型(电影/剧集/音乐…)、指向
/media下对应子目录。这里有两个选项值得留意: - 启用实时监控:文件系统变化时自动刷新库。挂载的是网络盘(NFS/SMB)时建议关掉,否则会反复触发扫描 - 媒体信息保存到媒体文件所在位置:勾了会在片源目录里写.nfo和海报图。开了只读挂载的话这项会失效(这正是挂:ro的影响之一),不想要额外文件就别勾 - 设置元数据语言:首选语言选"中文",国家选"中国"。这决定刮削器优先拉中文简介和中文海报
完成后会提示"您可以开始使用 Jellyfin 了",用刚设的管理员账号登录。
刮削出不来海报/简介怎么办:TMDb 在国内直连经常失败。两个解法:给容器加代理环境变量(HTTP_PROXY / HTTPS_PROXY,Jellyfin 的 .NET 底层会读),或者在 1Panel 的应用商店里装一个 OpenClash/mihomo(第 13 期 ntfy 那台机器上跑过)做透明代理。实在不行,手动去 TMDb 网站搜到片子的 ID,在 Jellyfin 里"识别"功能里填进去也行。
最小可用配置
装完先别急着看片,按下面这套配完再开始,后面能省很多事:
服务器设置(控制台 → 网络)
| 项 | 建议值 | 为什么 |
|---|---|---|
| 基础服务器 URL | 留空(不用子路径) | 设了 Base URL 会导致部分客户端连不上,官方文档明确列了一堆兼容问题 |
| 局域网网络 | 192.168.31.0/24(按实际网段) |
决定哪些 IP 算"本地",影响"允许远程连接"的判定 |
| 允许远程连接 | 局域网用默认开启;有公网访问需求再关 | 关掉后外部 IP 连不上,更安全 |
转码设置(控制台 → 播放 → 转码)
| 项 | 建议值 | 为什么 |
|---|---|---|
| 硬件加速 | 有核显选 QSV,没核显留空 | 留空即纯 CPU 软转,2 核机器带不动 4K |
| 启用硬件解码 | 按你的 GPU 支持情况勾 | 只勾 GPU 真支持的,勾多了反而失败回退软解 |
| 转码临时文件路径 | /cache |
默认就是这个,确认一下没被改到 /config 里 |
库设置
- 关闭"启用实时监控"(如果媒体在 NAS/NFS/SMB 上)
- 开启"仅保存图像到媒体文件夹"关闭(保持默认在
/config里,备份元数据才完整)
这一节没有一步是必须的——Jellyfin 装完开箱就能用。上面这些是在"能跑"和"用得省心"之间拉平的那一段。
硬件转码(要不要配,怎么配)
这是 Jellyfin 部署里唯一真正有技术含量的环节,值得单独说。
先判断要不要。如果你只在家用电视上看,电视本身能解大部分格式(H.264、HEVC 基本都行),Jellyfin 会走 Direct Play——服务器不转码、只传文件,CPU 几乎零负载。这种场景不需要配硬解。什么时候需要:手机在外面用流量看(带宽不够要降码率)、老电视解不动 HEVC、或者字幕烧录需求(内嵌特效字幕必须转码才能烧进去)。
核显方案(Intel QSV,最常见)
官方镜像里已经装好了 Intel 的用户态驱动和 OpenCL runtime(我查了 Dockerfile,里面直接从 Intel 官方源拉了 compute-runtime 全家桶),你只需要把设备透传进去:
devices:
- /dev/dri/renderD128:/dev/dri/renderD128 # 只透传 render 节点,不要透传 card0
group_add:
- "122" # 宿主机 render 组的 GID
那个 GID 必须按你宿主机实际情况查,不能照抄文档里的 122:
getent group render | cut -d: -f3
如果输出不是 render 而是 video 或 input,就把对应组的 GID 填进去。为什么两个都要配:devices 是把设备文件带进容器,group_add 是把容器内的进程加入宿主机拥有这个设备的组——设备节点在宿主机上通常是 crw-rw---- 权限,光有设备文件、不在组里,照样打不开。这是 Jellyfin 官方文档反复强调的组合,缺一不可。
验证是否生效:
# 容器内跑 vainfo,能列出 codec 支持就是通了
docker exec -it jellyfin /usr/lib/jellyfin-ffmpeg/vainfo
NVIDIA 方案:宿主机装 nvidia-container-toolkit,compose 里加 deploy.resources.reservations.devices 段或直接 gpus: all。镜像里 NVIDIA_VISIBLE_DEVICES=all、NVIDIA_DRIVER_CAPABILITIES=compute,video,utility 都已经设好了,不用额外加环境变量。
AMD 方案:走 VA-API,设备透传方式和 Intel 一样(/dev/dri/renderD128),但官方镜像里没有 AMD 的用户态驱动,需要自己装 libva-mesa-driver——除非你明确知道自己在干什么,否则不推荐折腾。
Rockchip 方案(RK3588 类盒子):镜像对 arm64 架构内置了 libmali 驱动,RKMPP 是支持的。飞牛这类 ARM 小机器上跑 Jellyfin 就走这条路。
树莓派:官方已弃用 V4L2 硬解支持,文档明确说"未来不太可能修复"。别在树莓派上指望硬转码。
告警/通知配置
Jellyfin 不是监控工具,它不会"挂了自己喊人"。往期的老规矩:保活交给第 1 期 Uptime Kuma,监控地址 http://<服务器IP>:8096/health——这是官方镜像内置健康检查用的同一个端点,返回 200 就是活的。
Jellyfin 自己有的"通知"是另一种东西:用户事件通知。在控制台 → 插件里装"Notifications"相关插件后,可以配置"新人注册时通知管理员""转码开始时通知"这类事件,支持 webhook、邮件、Telegram。这是事件通知,不是系统告警,别搞混。
如果你的需求是"转码队列爆了告诉我""磁盘满了告诉我",那都不是 Jellyfin 的活,配好 Uptime Kuma 对 8096 端口和宿主机磁盘的监控就够了。
反向代理与 HTTPS
只在家里看,什么都不用配,http://IP:8096 直接用。想在外面看,上反代是官方推荐姿势(Jellyfin 自己的 HTTPS 支持存在但需要证书,文档明确说"强烈建议交给反代处理")。
用第 2 期的 NPM(Nginx Proxy Manager)举最短路径:
- Proxy Hosts → Add Proxy Host
- Domain:
jf.example.com;Forward Hostname:jellyfin(同 Docker 网络用容器名);Forward Port:8096 - 勾上 "Websockets Support"(关键,Jellyfin 用 WebSocket 推送播放进度和远程控制指令,不勾会有各种诡异问题)
- SSL 标签页:Request a new certificate,勾 Force HTTPS
配完之后还有一步官方文档反复强调、但几乎所有人都会漏的:
进 Jellyfin 控制台 → 网络 → "已知代理"(Known Proxies),把反向代理的 IP 填进去。
不填会怎样:Jellyfin 默认丢弃所有来自未知代理的 X-Forwarded-For 头(这是防止恶意设备伪造 IP 的安全机制)。后果是 Jellyfin 看到的所有请求都来自反代的 IP(通常是 127.0.0.1 或 172.17.0.1),它会把所有人判定为"本地用户"——于是你在网络设置里做的"禁止远程连接"、按用户限制远程访问,全部失效,而且没有任何报错,纯粹是静默失效。
如果你用的是裸 nginx 而不是 NPM,官方推荐的配置里有两个容易漏的点:
location / {
proxy_pass http://127.0.0.1:8096;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_buffering off; # 流媒体必须关缓冲,否则拖进度条卡
}
location /socket {
proxy_pass http://127.0.0.1:8096;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade; # WebSocket 升级头
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
}
client_max_body_size 20M 也建议加——默认 1M 会导致上传大尺寸海报图失败。
踩坑清单
这期的坑比往期都多,因为这个项目体量大、历史包袱重:
- 没有降级机制。官方文档原话:"一旦新版本启动过,迁移立即执行,数据将不再兼容旧版本,唯一恢复方式是还原备份。" 这意味着升级 Jellyfin 和升级其他 Docker 应用的心态完全不同——升级前必须备份
/config,尤其跨大版本 - 10.11 → 12.0 是一次大迁移。数据库结构大改(播放列表和合集从序列化字段变成真正的关系表
LinkedChildren)。官方要求的升级路径:10.10.7 或 10.11.x 可以直接升 12.0,更老的版本先升到 10.10.7 再跳。升级前把第三方插件全部卸载,升完再装——12.0 的插件需要适配新数据库 - 12.0 移除了
/emby/*和/mediabrowser/*兼容路由。很多老教程、老客户端、老工具链还在用/emby前缀的地址,升到 12.x 后这些全部 404。如果你有脚本或第三方 App 用这种地址,升级前先改 - EasyPassword(简单 PIN)没了。12.0 移除了
POST /Users/{userId}/EasyPassword接口和整个简单 PIN 功能,只保留完整密码 - 旧版鉴权默认禁用。12.0 起 legacy authorization 默认关闭,且迁移会主动关掉已开启的。还在用老 API key 方式的脚本会突然 401
- 升完 12.0 必须做一次完整媒体库扫描。官方说明:自动识别的多版本媒体会因数据类型问题被清掉,全库扫描后恢复。第一次扫描会明显变慢,因为要做一次全路径校验
- 刮削失败多半是网络问题。TMDb 在国内不稳定。解决方案按顺序试:容器加
HTTP_PROXY/HTTPS_PROXY环境变量 → 主机层面透明代理 → 手动"识别"填 TMDb ID - 硬解配了却还在软转。九成是
group_add的 GID 不对(照抄文档的 122 但你机器上不是)。docker exec jellyfin vainfo跑不通就是权限没通,先解决这个再谈转码 - 反代后"允许远程连接"失效。忘了在 Known Proxies 里填反代 IP,所有请求都被当成本地请求。表现是"设置里关了远程但外面照样能连"
- WebSocket 没转发。NPM 忘勾 Websockets Support、或裸 nginx 没写
location /socket段。表现为网页端播放进度条不动、远程控制另一个会话没反应
备份
Jellyfin 从 10.11 起内置了备份功能,这是这个项目近几年最实用的新特性之一。
在线备份:控制台 → 备份 → 创建备份。可选备份内容:数据库(必选)、元数据、字幕、Trickplay(预览缩略图)。生成一个 zip 放在 <config>/data/backups/。备份前会检查至少 5GB 可用空间——如果你勾了字幕和 Trickplay,5GB 可能不够,提前确认空间。
恢复:同一个页面里选中备份点恢复;或者启动时带参数:
docker run --rm -v /opt/jellyfin/config:/config \
jellyfin/jellyfin:12.1 \
--restore-archive /config/data/backups/backup-xxxx.zip
手动备份(最彻底):
# 1. 先停容器(必须,否则 SQLite 数据库锁着,备份出来可能损坏)
docker stop jellyfin
# 2. 拷贝整个 config 目录
tar czf /opt/backups/jellyfin-$(date +%Y%m%d).tar.gz -C /opt/jellyfin config
# 3. 重新启动
docker start jellyfin
为什么必须先停:jellyfin.db 是 SQLite 文件,运行中直接 cp 出来的副本在 WAL 模式下很可能不一致,恢复时打不开。第 15 期 linkding 那期说的 manage.py full_backup 是应用层感知事务的备份,Jellyfin 的对应物就是上面说的内置备份功能(它也是在线安全的);手动 cp 就老老实实先停。
媒体文件本身不用备——那些是你的原始片源,丢了就真没了,但 Jellyfin 的备份不含它们。元数据、观看记录、用户信息全在 /config 里,备它就够了。
小结
适合谁
- 手里已有片源(或打算认真收集),想给全家建一个统一影视库的人
- 受够了网盘在线播放画质和限制的人
- 想给家人各自建账号、各自记录观看进度的人
- 手里有 Intel 核显(6 代以上)或 NVIDIA 显卡,想让转码不占 CPU 的人
- 已经跑着 Immich(第 4 期)和 Navidrome(第 8 期)的人——这三件套补齐后,家庭媒体这一块就完全自持了
不适合谁
- 没有 NAS 或服务器、想把电影"放云上随时随地看"的人——网盘还是更省心(虽然代价是画质和数据主权)
- 想"一键追新番自动下载"的人——那是 Sonarr/Radarr 的活,Jellyfin 只管已有内容
- 2 核 2G 又没有核显、还想在手机流量下看 4K 的人——转码会把你 CPU 打满,画质还差
- 需要"发个链接给朋友在线看"的人——Jellyfin 没有外链分享这个概念
项目地址
- GitHub:https://github.com/jellyfin/jellyfin
- 官网与文档:https://jellyfin.org
- Docker 镜像:
jellyfin/jellyfin(Docker Hub)/ghcr.io/jellyfin/jellyfin - 硬件加速文档:https://jellyfin.org/docs/general/post-install/transcoding/hardware-acceleration/
- 备份文档:https://jellyfin.org/docs/general/administration/backup-and-restore