Jellyfin 作为一款免费开源的媒体服务器软件，一直是众多影音爱好者搭建私人影音库的首选。最近，其 12.0 版本正式发布，在 Hacker News 上引发了热烈讨论。如果你正在使用 Jellyfin，或者正打算从 Plex/Emby 迁移过来，这篇文章将为你带来 12.0 版本的升级全攻略。

一、12.0 版本带来了什么？

这次大版本更新并非简单的修修补补，而是包含了许多底层架构的改进和用户可见的新功能。根据官方发布说明，有几个亮点值得关注：

1. 性能大幅提升：新版对转码引擎和数据库查询进行了深度优化。尤其是在处理高码率 4K 原盘或同时服务多个客户端时，CPU 占用和内存消耗有明显下降，对使用 NAS 或老旧电脑搭建服务器的用户来说，体验改善非常显著。
2. 全新的播放器内核：内置的网页播放器得到了重构，对 HDR 色调映射的支持更加完善，色彩还原更准确。同时，字幕渲染的兼容性也更好，解决了此前部分 ASS 特效字幕乱码或错位的问题。
3. 更精细的元数据管理：在刮削电影和剧集信息时，现在可以更灵活地控制字段，例如单独锁定某一季的封面，或者手动覆盖演员头像，对于资料库整理强迫症用户来说是一大福音。
4. 同步播放与投屏优化：增强了与 Chromecast 及 AirPlay 设备的兼容性，同步播放时的音画同步问题得到了修复。

二、升级前的必要准备（重要！）

在动手升级之前，请务必做好以下两步，否则可能导致资料库丢失或配置重置：

1. 备份数据库与配置：Jellyfin 的所有核心数据（包括用户信息、观看进度、媒体库路径）都存储在 /var/lib/jellyfin（Linux）或安装目录下的 data 文件夹中。升级前，请完整复制该文件夹到安全位置。
2. 检查插件兼容性：部分第三方插件（如字幕下载、Trakt 同步）可能尚未适配 12.0 的 API。建议在升级前记录下已安装的插件列表，升级后逐一检查更新，避免因插件冲突导致服务崩溃。

三、手把手升级教程（Docker 与 传统安装）

方案 A：Docker 用户（推荐）

如果你使用 Docker 部署，升级过程最为简单：

1. 拉取新镜像：docker pull jellyfin/jellyfin:latest
2. 停止并删除旧容器：docker stop jellyfin && docker rm jellyfin
3. 重新运行容器：使用你原来的 docker run 命令（或 docker-compose.yml）重新创建容器，注意挂载的配置目录路径不要改变。
4. 等待启动：新版首次启动会自动迁移数据库，可能需要几分钟时间，请耐心等待，不要强制中断。