- Published on
Jellyfin 12.0 发布：性能提升、书籍支持与现代布局
- Authors
- Name
- 0xC0ncord
- jellyfin.org
版本号变更：从 10.12 到 12.0
Jellyfin 12.0 最直观的变化是版本号直接跳过了“10.”前缀，从 10.11.x 直接变为 12.0。团队认为此前 10.11 这样的大版本升级因为受限于固定前缀而被低估为小更新，因此决定废弃旧命名方式。这意味着解析版本号的所有第三方工具和脚本都需要相应更新。
升级前必读：TL; DR
升级前务必阅读以下注意事项：
- 必须停止 Jellyfin 并完整备份数据与配置目录，因为新版本会修改数据库结构且首次启动时重写数据，无法回退。
- 当前必须运行 10.10.7 或任意 10.11.x 版本，低于 10.10.7 需先升级到该版本。
- 升级后必须执行一次完整的库扫描，该扫描会清理旧残留数据并重建版本链接，耗时显著增加，属正常现象。
- 扫描期间不要停止服务器。
- 用户名现在不区分大小写，若存在仅大小写不同的用户名，数据库迁移会失败。
- 移除所有第三方插件，因为它们需要重新编译以兼容 12.0。官方插件已更新。
- 非常古老的第三方客户端将无法登录，因为已移除遗留的 /emby/ 和 /mediabrowser/ 端点及旧的登录方式。
数据库性能全面优化
继 10.11 重写库数据库后，12.0 重点提升了读取性能。最显著的改进是播放列表和集合的存储方式：过去每个播放列表内所有条目以单一列表存储，数据库无法直接查询内部数据，导致获取计数、显示单页或编辑条目都需要加载整个列表。现在每个条目独立成行，数据库可以快速计数、分页和单条目增删。
其他性能优化包括：
- 批量删除大量条目不再中途失败。
- “继续观看”、“下一集”、回看、音乐最新媒体、艺术家查询、文件夹观看计数等操作均提速。
- 重型数据库维护不再与库扫描同时运行，避免资源竞争。
这些改进主要作用于读取路径，扫描器本身速度并非此版本目标。
新增功能亮点
书籍与漫画的原生支持
之前依赖 Bookshelf 插件的功能现已集成到服务器核心：
- 直接从 OPF、ComicInfo 和 ComicBookInfo 元数据文件读取信息，无需插件。
- 自动为 EPUB 和漫画生成封面图，有声读物支持外部封面。
- 从文件名解析书名、索引、年份、系列以及漫画的卷号和章节号。
- 提取漫画与 PDF 的页数，提取有声读物的章节。
- Book shelf 拆分为独立的 GoogleBooks 和 ComicVine 提供者，新增 OpenLibrary 插件。
- Web 客户端提供现代书籍布局（多种视图类型、分页），作者页面展示其作品，阅读界面统一全屏和滑动导航，支持 iOS 后台播放。
多版本剧集支持
以往“替换版本”仅限电影，现在剧集也支持。用户可将同一剧集的广播版与加长版、1080P 与 4K 版本分组，且各版本独立的续播信息得以保留。这导致升级后必须重新扫描库以重建自动版本链接。
可扩展的推荐与搜索
“相似推荐”和“建议行”的数据源现在可在库设置中分别选择（如音乐库使用 ListenBrainz）。插件可以添加自己的搜索结果，扩展搜索范围。这两个系统均已文档化，便于开发者编写插件。
现代布局成为默认
此前标记为“实验性”的布局现在称为“现代布局”，在桌面和移动端成为默认选项。原先的布局更名为“传统布局”。电视设备继续使用 TV 布局。所有主题（暗色、亮色、WMC、Blue Radiance、Apple TV、Purple Haze）都基于 CSS 变量构建的共享基础主题，便于自定义。
其他改进
- 库工具栏合并到应用栏，带有粘性库标题。
- 所有库都增加集合和播放列表选项卡。
- 更新了音乐视频、混合媒体、收藏、播放列表和书籍视图。
- 新增音频和字幕语言过滤器，重置筛选按钮，以及工作室搜索。
升级后的行为变化
- 字幕设置改为按库配置，不再全局统一。
- 排序更一致，部分库顺序可能略有不同。
- 低分辨率海报不再拉伸至全尺寸，而是以实际分辨率显示（更小但更清晰）。
- .ogg 文件被视为音频而非视频，旧视频文件将在下次扫描时重新分类。
- 用户名允许切换大小写，但不能出现仅大小写不同的两个账号。
- 播放时遵循符号链接（而非扫描时）。
安全修复
此版本包含服务器和 Web 客户端的多项安全修复，包括阻止精心构造的请求访问 Jellyfin 预期目录之外的文件，以及防止设置向导在已配置服务器上被重新运行等。
总之，Jellyfin 12.0 是一次重大升级，在性能、功能和安全性上都有显著进步，但升级前务必仔细阅读 TL;DR 部分并做好备份。
原标题：Jellyfin 12.0。 HN 原始发布时间：2026年9月8日星期二。当前记录为 586 分、328 条评论。