9月8日,开源媒体服务器 Jellyfin 发布了 12.0 稳定版:去掉"10.“版本号前缀、继续数据库改造、原生支持书籍与漫画、启用现代化 UI,并修复多个安全问题,官方明确建议用户升级。知乎随之出现了两个相关讨论问题,影音库用户的升级咨询也跟着多了起来。但对家庭影音库用户来说,这条新闻真正的问题不是"12.0 好不好”,而是:你的服务端、你跟着做的教程、你的播放端,大概率不在同一个版本线上。"直接升级"不是一刀切答案,这篇按部署方式把账拆开。IT之家
一、12.0 到底改了什么,哪条跟你有关
把官方发布说明和 IT之家的整理对起来看,四项变化里对影音库用户的影响权重差别很大:
版本号对齐:移除"10."前缀,服务端与客户端版本号终于走到一条线上,这是知乎问题下最直观的反馈。听起来是面子工程,实际省掉的是过去"服务端 10.x、客户端 1.x、插件各报各版本"的排错成本。知乎
数据库改造继续推进:这是从 10.11 就开始的大工程,12.0 继续做性能优化。对小库无感,对几千部电影、几万集剧集的大库才是真收益——扫描、刮削、全家观看进度回写,全压在这个库上。知乎
原生支持书籍与漫画:影音库第一次把"非视频"内容收进正编,之前要在同一台机器上再跑一个专门管电子书的自建服务。家里有实体书扫描档、漫画库的,可以少维护一个容器。
现代化 UI + 安全修复:官方建议升级的主要触发点在这里,公网暴露过的用户尤其别拖。
二、真正的坎:你用的构建,可能还不是 12.0 的构建
国内影音库圈最主流的教程路线,从来不是官方镜像,而是 NAS 圈"封神"的 nyanmisaka 硬解特供版(俗称 N 大特供版)。参照性最强的一篇实测教程是 9 月 20 日知乎上一条近万浏览的回答:基于 nyanmisaka/jellyfin:260326-amd64,实测引擎仍是 Jellyfin 10.10.7(FFmpeg 7.1.3)。构建号 260326 按该镜像 YYMMDD-架构 的命名规则就是今年 3 月的日子。也就是说,截至 9 月下旬,"硬解"这条国内用户最依赖的路线上,12.0 引擎还没接上。知乎知乎
所以这波升级要分四类人:
1. 官方镜像 / 裸装用户:能走,但先备份。
换标签或走系统更新前,把 ./config 目录完整备份。用户账号、观看进度、库索引、插件配置都在 config 里;片文件本身在挂载目录不会丢,但 config 没了,等于全家人的观看进度加一次整库重刮全部重来。大版本数据库迁移后,"降级"不会像装错一个 APK 那样体面。知乎
2. 硬解特供构建用户:等构建追平,别交叉换镜像。
这类镜像按 YYMMDD-架构 命名标签,官方那种 10.10.7 式的语义化标签在这里不适用,教程也明确提醒升级时要改标签并核对维护者说明。在 nyanmisaka 更新到 12.x 引擎之前,最稳的做法是留在当前构建;看到"Jellyfin 12.0 发布"就直接把 jellyfin/jellyfin:latest 换上去顶替硬解镜像,等于把 QSV/VAAPI/NVENC 那条好不容易调通的转码管线推回未知状态——对客厅 4K HDR 直通用户,转码回退比没有新 UI 难受得多。知乎
3. 品牌 NAS 用户(绿联、飞牛、群晖、威联通等):节奏交给商店。
你的 Jellyfin 可能是套件中心或容器中心里的托管版本,升级由厂商适配。这个月从"付费片库停服"迁过来自建的新用户不少,小红书那篇从 Emby 闭源说起、讲自己转投 Jellyfin 的折腾记录至今还在涨互动。对这批刚上船的用户,第一建议同样是:等商店版本号追平再动,别手动折腾。小红书
4. 只在客厅电视端操作的用户:先升客户端,稳赚。
12.0 同期安卓电视端(Android TV 客户端 v0.20)刚完成大更新:DTS-HD MA、DTS-X 源码直通和 SSA/ASS 字幕支持都已解决,只剩 PGS 字幕位置的小毛病,微博用户的原话是"基本可以弃用 Plex 了"。这类改进不依赖服务端版本,现在就更新,客厅收益立竿见影。微博
三、升级前的三分钟自查(针对能动的两类人)
备份 /config:tar 一份扔到网盘或另一块盘上,教程作者也把"定期备份 config"列为生产环境建议。
查插件链:metashark、Metatube 这类中文刮削插件是影音库的体验命脉,大版本后社区插件适配常有时间差——先把插件更新状态看完,再考虑动主库,别在正式版环境直接对整库重扫。
小库试水:新建一个只放几十部片、用标准命名的测试库先扫一遍。命名这件事本身就是中文片库的最大变量:9 月 18 日那篇用 AI 整理 300 部电影的知乎文章讲得很直白,真正麻烦的不是格式,而是需要人工解码的规避性命名。你库里这种片子越多,大版本后重刮的成本越高。知乎
回滚预案:确认 docker compose 里还留着旧标签的写法,出问题改回一行就能退。
四、一句话结论
官方构建用户:备份 config,直接升级,数据库和安全修复先吃。
硬解特供、品牌 NAS 用户:等构建追平,别交叉升级。
电视端用户:客户端现在就更新,服务端的事另说。
还在纠结片库放哪的用户:12.0 让"免费、开源、无账号"这条路线更稳了一点;在付费片库这个月接连停服退场的背景下,自建正在从爱好变成默认答案。
继续观察:nyanmisaka 标签何时跟上 12.x 引擎;各大品牌 NAS 商店的版本适配公告;Android TV 客户端下一版对 PGS 字幕的处理。这三条里任何一条落地,都比你今晚手痒点下的那个"检查更新"更值得动手。