先说一个眼熟的场景
你现在点开影音库的海报墙，跑的很可能是这么一套组合：Docker 里挂着 nyanmisaka 特调镜像，tag 还是今年 3 月 26 日那个构建；引擎是 Jellyfin 10.10.7，Intel 核显硬解、中文字幕补丁都调教好了；片源一半在本地盘、一半是网盘 STRM「指路牌」；电视端连 Infuse 或 VidHub，爸妈只管按遥控器。
9 月下旬还在更新的中文教程（知乎「程序员老张」9 月 20 日的部署文）依然基于这个引擎讲。 但服务端那边，两周之内变了一次天：9 月 8 日 Jellyfin 12.0 稳定版发布，官方建议升级；9 月 15 日 12.1 又追了 47 条修复。 IT之家 9 月 8 日报道的原话是：本次更新「移除版本号 10. 前缀，优化了数据库性能，原生集成书籍漫画支持，启用现代化 UI，还修复多个安全问题」，知乎上那两个提问干脆用了「版本号终于对齐」的说法。 一边是官方发布节奏正常，一边是你实际在拉的那个镜像还停在 3 月。这中间的错位，才是影音库用户此刻真正要算的账：升不升、什么时候升、升完要接受什么。这篇一次拆完。知乎GitHubIT之家知乎
12.0 到底改了什么：四个「硬变化」，三个值得在意的功能
先讲跟升级决策直接相关、也最容易被教程文章略过的部分。以下全部来自官方 v12.0 发布说明，不是二手转述：
1. 数据库迁移不可回退。 官方明确要求：升级前完整备份 data 目录，因为这一版的数据库变更「没有完整恢复就无法回退」。出问题不再是「换个镜像 tag 重新拉一下」，是还原备份、重配一遍的事。GitHub
2. 第三方插件必须先卸。 内置以外的所有插件，官方要求在迁移前移除——插件需要时间适配新数据库，升完再逐个加回去测试。你的库如果靠插件跑刮削、弹幕、消息推送，这一步等于先把「外挂器官」摘了上手术台。
3. Emby 时代的兼容路径被砍。 `/emby/` 和 `/mediabrowser/` 旧路由前缀整体移除，legacy 授权默认关闭，EasyPassword 直接删了。凡是还在走 Emby API 老路径接入的第三方客户端，你的服务端升上去之后，它面对的就是连不上。GitHub
4. 扫描和字幕的行为变了。 符号链接只在播放时才解析；全局字幕配置被移除，改成按媒体库分别配置。软链挂网盘目录的、习惯一套字幕字体喂全库的，都要重验。另外 Debian Bullseye、Ubuntu Focal 的系统包停更了，还在老底座上裸装的朋友，Docker 基本是唯一顺路。
功能面，三件事对影音库体验是真增量：
剧集多版本：同一集可以挂 TV 版、导演剪辑版、重制版，以前这待遇只有电影有；
推荐与搜索 providers：官方开了接口，插件可以扩展甚至替换搜索结果的生产逻辑——「海报墙给你荐片」这件事，开源阵营第一次有了正规入口；
三位数以上集数支持：长篇连载和周更动画卡了几年的 999+ 集编号问题，官方解决了。VobSub 字幕流、从季/集目录名解析 tmdbid/tvdbid/imdbid、OriginalLanguage 音频偏好也都在这批。
还有一个升级后必现的现象要先打预防针：官方说明里写了，升级后第一次全库扫描会明显比平时长，自动合并的「替代版本」会被清掉、需要重新扫描恢复，部分影片会像「新添加」一样出现在库里。这不是丢库，是官方预期行为——但你要是不知道，很容易当晚就以为翻车了。GitHub
为什么很多人的「升」，卡在镜像这一环
官方镜像当然早就就位。问题是中文影音库的主流从来不是官方原版：核显转码、字幕渲染这些坑，多数人是靠 nyanmisaka 这类特调镜像绕过去的，它在这个圈子里基本是 QSV 段的事实标准。
现状分两半。确定的一半：9 月 20 日的知乎教程还在用 260326 构建（10.10.7 引擎 + FFmpeg 7.1.3）做讲解——写教程的时候，12.x 的特调版还没走到「稳定可抄」这一步。动向的另一半：这个 fork 的 GitHub 仓库已经开出 `build-12.0` 分支，9 月 15 日的最新提交信息是「Bump version to 12.1」，追主线的意思很明确；但特调镜像的卖点（硬件解码补丁、字幕渲染、ARM 构建）有没有在新数据库结构上逐条验证过、稳定 tag 什么时候放出，截至本文发稿还没有公开答案。GitHub
小红书评论区里能看到真实的排队现场：有用户写「追 nyanmisaka/jellyfin:latest 更新，有最新进展麻烦 @ 我下」，底下高赞回复直接点破两头挤压：「这个 fork 版本号不跟着主线走，很多客户端不支持旧的服务端了」。 这就是影音库用户现在最拧巴的位置——往前，特调链路还没跟上 12；往后，客户端那边还在持续更新：Infuse 7 月底的大更新加了对 Emby/Jellyfin/Plex 转码的支持，2 月底官方账号宣布 8.3.9 连接 Jellyfin 时新增飞牛私有云，9 月中旬 VidHub 把电影库通上了电视。客户端每往前一步，你其实都在赌服务端版本别掉队。小红书微博小红书
微博上还有个细节值得记住：有 homelab 用户 7 月排查了半天「中文字幕变口口口」，最后发现问题不在 NAS 容器缺字体，而在他把编解码 offload 给了另一台机器的 rffmpeg——特调链路越长，升级时越是牵一发动全身，这类坑在版本切换期只会更多。微博
升级队列背后，还有件不方便说的事
7 月下旬，社区集中讨论了一件事：Jellyfin 三位联合创始人一周内全部辞职。项目负责人 Joshua Boniface 干了 7 年半，说自己严重倦怠，继续做下去对心理健康有风险；Andrew Rabert 因开发方向分歧和社区负面反馈离开；Anthony Lavado 说生活变化，得去做别的事。 今年 5 月团队就在官方博客抱怨过 AI 生成的低质量 PR 涌入、审核成本压垮志愿者。这条小红书（30 赞、11 评论）的总结挺冷静：AI 在改变开源项目的维护成本结构，而成本最终落在少数几个人身上。小红书
Boniface 走前给了两句定心的话：Jellyfin 会继续存在很长时间，交接是和平的、不会分叉。9 月 8 日、9 月 15 日连续两版、47 条修复的节奏，也看不出停摆。但「继任计划未公布」同样写在同一批讨论里。 对一个你打算用五年十年的自用系统，这不改变升不升的技术判断，只改变一件事：凡是「等生态跟上」的排期，心理预期要比过往更宽。小红书
决策表：五类人，对号入座
你是哪类 | 建议 | 理由 |
|---|---|---|
还没建库、双11准备装一套 | 直接官方 12.1 | 没有旧债，插件生态从第一天就按新结构装 |
用官方或 linuxserver 镜像、库在几千部以内 | 可备份后升 12.1 | 官方支持 10.10.7/10.11.x 直升，跳过 12.0 直接打补丁版 |
还在 10.9 及更早 | 先升到 10.10.7，再谈 12.0 | 官方不建议跨版本直跳，老库结构风险叠加 |
nyanmisaka 特调 + STRM 网盘库 + 核显转码 | 先不动，等 12.x 特调稳定 tag | 12.0 砍的旧路由、改的符号链接行为、插件要求，条条踩在这套组合的要害上 |
全家共用、电视端连着爸妈 | 双11 前锁版本 | 不可回退的迁移 + 首扫波动，对「别人也要用」的库最不友好 |
真要升，7 步；选择等，盯 4 个信号
升级 SOP，顺序别乱：
停服，完整备份 data 目录（数据库、海报缓存、插件配置一个不落）——这是唯一救生艇；
卸载全部第三方插件，记下版本号，方便回溯；
检查插件仓库地址回到官方 stable manifest（repo.jellyfin.org），改过 unstable 的先改回来；
拉 12.1 镜像启动——别从 12.0 停留，12.1 的 47 条修复里有「forced-only 字幕覆盖记忆字幕」「/UserViews 耗尽内存」这类正好踩在影音库日常上的补丁；
执行全库扫描，接受第一次特别慢、海报墙有「重新添加」的观感；
逐个加回核心插件，作者没发 12 适配 manifest 的就先空着；
逐端回归测试：核显直通、中文字幕渲染（含外挂 offload 链路）、远程访问、电视端连接，走 Emby 老路径的客户端逐一换协议或换端。
选择等待的，盯四个绿灯信号：
你在用的特调链路放出 12.x 系列的稳定镜像 tag；
你依赖的插件集中更新适配 12 的 manifest；
你手头的客户端里开始出现「拒绝旧服务端」的实测反馈；
第一波升级用户在社区把数据库、转码、字幕的坑报完——参考 12.1 的修复密度，这个周期大概率不会太长。GitHub
最后说这事的本质
影音库的账一直分两本：硬件账——盘的价、屏的价、盒子的价，过去两个月我们算了个遍；系统账——服务端、镜像、客户端，这三层的版本生态。9 月这波，是系统账翻页，而且翻的是不可回退的那一页。
它像智能手机用户面对一次大版本：新特性确实诱人——多版本、荐片、三位数集数；但你这个版本最不可替代的价值恰恰是「整库元数据 + 插件 + 客户端生态」在一种没人验证过的状态下跑得好好的。所以答案不需要一刀切：新装就升，官方镜像用户挑个有空备份的周末升，特调链路用户就安心等 tag。唯一现在就该做的一件事是——不管哪条路线，先把 data 目录完整备份一份。这条账，升不升都值。
