Jellyfin 12.0 正式发布，最显眼的变化是版本号从原本计划中的 10.12.0 调整为 12.0.0。这并不只是一次命名整理：服务器与 Web 客户端现在统一为 12.0.0，项目也计划改为每年推进一次主版本更新。对自建媒体服务的维护者而言，更值得关注的是数据库重构，以及书籍、漫画这两类内容进入媒体库后的使用路径。
去掉 10，不只是看起来整齐
Jellyfin 自 2018 年从 Emby 分叉后，长期使用 10.x 版本号。12.0 将此前的前缀移除，让服务端和 Web 客户端的主版本保持一致，升级沟通会更直接：部署清单、客户端兼容性说明和故障排查记录都可以围绕同一个版本号展开。
计划中的年度主版本节奏，也意味着运维策略应随之调整。过去可以把版本升级当成零散维护任务；今后更适合把它放进固定的年度变更窗口，提前准备备份、测试媒体扫描和客户端回归验证。
数据库重构为何影响实际部署
数据库通常不直接出现在播放器界面里，却承载着媒体元数据、扫描结果、用户状态和库索引。Jellyfin 12.0 的数据库重构意味着升级前后需要格外重视数据目录，而不是只替换容器镜像或二进制文件。
对于已有实例，几个边界需要明确：
- 不要把生产数据目录当作可随时重建的缓存目录。
- 大型媒体库的首次启动、迁移或重新扫描可能消耗较长时间和较多磁盘 I/O。
- 发生回退需求时，旧版本未必能安全读取已经完成迁移的数据。
- 非官方插件、定制脚本和直接查询数据库的运维工具，都应在升级前验证兼容性。
实践上，升级的关键不是“拉取新镜像”，而是让数据库迁移具备可恢复性。
用 Compose 做一次可回滚的 12.0 升级
下面的示例以 Docker Compose 为前提，假设现有 Jellyfin 的配置、缓存和媒体目录都通过宿主机路径挂载。镜像标签请按实际可用的 Jellyfin 12.0 发布标签调整；不要直接把示例中的路径照搬到生产环境。
先停止服务并备份持久化目录：
cd /srv/jellyfin
docker compose down
tar -C /srv/jellyfin -czf "jellyfin-backup-$(date +%F).tgz" config cache
然后将 compose.yaml 中的服务固定到 12.0 系列，而不是使用漂移的 latest 标签：
services:
jellyfin:
image: jellyfin/jellyfin:12.0.0
container_name: jellyfin
restart: unless-stopped
ports:
- "8096:8096"
volumes:
- ./config:/config
- ./cache:/cache
- /mnt/media/movies:/media/movies:ro
- /mnt/media/books:/media/books:ro
- /mnt/media/comics:/media/comics:ro
environment:
- TZ=Asia/Shanghai
启动后，不要立刻删除旧备份。先检查容器日志和健康状态，再进入管理界面确认主要媒体库、用户播放记录和元数据是否正常：
docker compose pull
docker compose up -d
docker compose logs --tail=200 jellyfin
curl -I http://127.0.0.1:8096
curl 能证明 HTTP 服务已响应，但不能替代功能验证。至少应抽查一个电影、一个剧集、一本电子书或漫画内容，以及一个已有用户的继续观看记录。
书籍和漫画进入同一个媒体中心
12.0 的另一项重点是书籍与漫画支持。这让 Jellyfin 的定位不再只围绕音视频：家庭 NAS 上常见的电影、音乐、电子书和漫画，可以开始在同一套账户、访问控制和服务入口下管理。
不过，“放进同一个服务”不等于“所有文件格式和阅读体验都完全相同”。可以这样实践：为书籍和漫画分别建立目录与媒体库，避免把扫描规则、封面命名和权限策略混在一起。漫画文件通常更适合按系列和卷册分层；电子书则应保持作者、书名和系列字段的一致性，减少匹配错误。
例如，目录可以保持简单而稳定：
/mnt/media/books/
Ursula K. Le Guin/
Earthsea Cycle/
A Wizard of Earthsea.epub
/mnt/media/comics/
Saga/
Saga - Vol. 01.cbz
Saga - Vol. 02.cbz
如果媒体库已有大量存量文件，先选一个小目录建立测试库，观察扫描速度、识别结果和客户端展示，再扩大到完整目录。这样能避免一次全库扫描后才发现命名规则不适合当前的元数据行为。
把 12.0 当成一次受控迁移
Jellyfin 12.0 的版本号调整提供了清晰的发布节奏，而数据库重构和书籍、漫画支持才是更影响日常使用的变化。升级前应完成数据备份和插件盘点；升级后应验证迁移结果、扫描负载和客户端兼容性；确认稳定后，再将书籍与漫画逐步纳入正式媒体库。
对于小型家庭实例，一次停机备份后升级通常足够。对于多人使用或媒体规模较大的服务器，更稳妥的做法是在副本数据目录上先演练一次 12.0 启动与扫描，把迁移风险从正式服务中隔离出来。