开源媒体服务器Jellyfin 12正式发布 版本好直接跳级且属于破坏性更新 需注意兼容性故障
内容提要
Jellyfin 发布 v12.0 正式版，为破坏性更新。版本号改用 v1x.0 系列，避免误认为 10.x 是小更新。新版重构数据库、升级 .NET 10 并修改插件接口，第三方插件需重新适配，旧客户端可能无法连接。升级前须完整备份数据，且无法直接回滚。新版还优化性能，增强图书漫画支持，升级 FFmpeg 8.1 并修复安全问题。
延伸解读
版本号跳跃背后的逻辑
Jellyfin 从 10.11 直接跳到 12.0，并非简单数字游戏。项目组解释，旧版 10.x 前缀长期不变，容易让用户误以为 10.11 只是小更新，而实际上每个 10.x 都是大版本。新规则下，v1x.0 代表大版本，v12.x 则是修复和安全更新。这种调整让用户一眼就能分辨版本性质，避免因误解而错过重要升级或误判更新规模。
升级风险与回滚限制
v12.0 重构了底层数据库，并移除旧版 /emby/ 和 /mediabrowser/ 地址，默认关闭废弃的登录认证方式。这些改动可能导致旧客户端无法连接，且升级后无法直接回滚到旧版本。团队强调，升级前必须停止服务器，完整备份数据库和配置目录，否则一旦出现问题，只能依靠备份恢复。这是本次升级最需要警惕的兼容性风险。
插件与客户端兼容性
由于升级到 .NET 10 并修改了多项插件接口，针对 10.11 编译的第三方插件无法直接加载，必须由开发者重新适配。官方插件虽已更新，但用户升级前最好先移除第三方插件，避免影响升级过程。同时，旧版客户端可能因地址移除和认证方式关闭而无法连接，建议提前确认客户端兼容性，或等待客户端更新。
功能与性能改进
新版优化了大型播放列表、合集、继续观看、下一集和音乐库的查询速度，并支持电视剧 1080P、4K 及不同剪辑版本的合并管理。图书和漫画支持显著增强，可直接读取 EPUB、ComicInfo 等元数据并生成封面、页数和章节信息。网页端默认启用 Modern 布局，FFmpeg 升级至 8.1，改善转码、字幕和视频兼容性，同时包含多项安全修复。
Q&A
Jellyfin 12 正式版为什么被称为破坏性更新？
Jellyfin 12 正式版是破坏性更新，因为它重构了底层数据库、移除了旧版 /emby/ 和 /mediabrowser/ 地址、默认关闭了废弃的登录认证方式，并修改了插件接口，导致旧客户端可能无法连接，第三方插件必须重新适配。
Jellyfin 版本号为什么从 10.x 直接跳到 12.0？
项目组决定移除长期不变的 10. 前缀，因为类似 10.11 的编号容易让用户误以为是小更新，但实际上每个版本都是大版本更新。从 v12.0 开始，大版本使用 1x.0 系列，小版本使用 v12.x 子版本，以便用户区分。
升级到 Jellyfin 12 前必须做哪些准备？
升级前必须停止服务器、完整备份数据库和配置目录，并建议先移除第三方插件以避免插件问题影响升级。升级后不能直接回滚，只能通过备份恢复。
Jellyfin 12 对第三方插件和客户端有什么影响？
Jellyfin 12 升级到 .NET 10 并修改了多项插件接口，针对 10.11 编译的插件无法直接加载，必须由开发者重新适配。官方插件已完成更新，但第三方插件需等待适配。此外，移除旧地址和关闭废弃登录方式可能导致旧客户端无法连接。
Jellyfin 12 在性能和功能上有哪些改进？
新版本优化了数据库重构后的性能，提升了大型播放列表、合集、继续观看、下一集和音乐库查询速度。电视剧支持 1080P、4K 和不同剪辑版本合并管理。图书和漫画支持增强，整合了 Bookshelf 插件功能，可直接读取 EPUB、ComicInfo 等元数据并生成封面、页数和章节信息。网页端默认启用 Modern 布局，更新了图书阅读界面、筛选和缓存机制。媒体处理升级到 FFmpeg 8.1，改善转码、字幕和视频兼容性。
Jellyfin 12 包含哪些安全修复？
Jellyfin 12 包含多项服务器和 Web 客户端安全修复，官方建议用户在做好完整数据备份、确认客户端和插件兼容性后尽快升级，以免相关漏洞被黑客利用。
