本文档为 Jellyfin 媒体服务器的 10.11.0 版本提供详细说明。请注意，此版本包含重大架构变更，升级前请务必完整阅读以下内容。

重要升级须知

数据库迁移核心变更

本次更新的核心变更是完成了 EFCore 数据库迁移，几乎涉及 Jellyfin 后端所有模块，请特别注意以下关键事项：

  • 版本要求：必须从 10.10.x 或 10.9.x 版本升级。从更早版本升级将导致失败。若升级后服务器无法启动，请检查日志中是否存在 Your database does not meet the required standard 提示。

  • 迁移过程：

    • 首次启动时将执行长时间运行的迁移任务（转换数据库格式、移动文件等）
    • 绝对不要中断此过程，否则会导致数据库损坏
    • 迁移时间可能长达数天（取决于库大小）
    • 失败时可恢复原始数据库重新尝试

  • 已知限制：

    • 搜索和多版本功能可能存在未修复问题
    • 系列合并功能在部分情况下失效

升级前准备建议

  1. 库页面设置：将用户设置中的库页面大小调整为 ≤100 以提高性能
  2. 插件处理：
    • 移除所有第三方插件（仅保留内置插件）
    • 测试插件需切换至不稳定仓库：https://repo.jellyfin.org/files/plugin-unstable/manifest.json
  3. 扫描建议：迁移完成后执行全库扫描（首次扫描时间可能显著延长）
  4. 并行扫描设置：调整 仪表盘 > 常规 > 性能 > 并行库扫描任务限制 参数（建议值：CPU核心数-3）

新增功能亮点

网页界面增强

  • 搜索优化：显著提升搜索性能
  • 收藏夹扩展：支持直播频道、音乐视频、相册等媒体类型
  • HEVC 支持：Firefox 134+ 原生支持
  • 界面自定义：
    • 可禁用字幕原生样式
    • 登录页显示启动画面
    • 新增服务器品牌配置页面（支持自定义启动图/CSS等）

仪表盘改进

  • 存储可视化：新增服务器路径存储用量图表
  • 备份系统：支持配置/数据库的创建与恢复
  • 日志查看器：全新设计的日志查看界面

服务器后端升级

  • EFCore 数据库：

    • 所有数据统一存储为 jellyfin.db
    • 高性能设备显著提速，低端设备可能降速

  • 锁机制优化：新增三种数据库锁行为模式（配置文件 database.xml 中设置）：

    • NoLock（默认）：仅依赖数据库原生锁
    • Optimistic：检测到锁时延迟重试
    • Pessimistic：强制 “单写多读” 模式（影响性能）

  • 空间检测：启动时自动检查系统目录（需至少 2GB 可用空间）

  • 元数据清理：自动清理未使用流派/工作室数据

转码器更新

  • FFmpeg 7.1：升级至最新版本
  • HDR 优化：
    • Intel/RK3588 芯片支持 3D LUT 色调映射
    • RK3588 支持杜比视界 Profile 5
  • AV1 解码：Apple VideoToolbox 硬件加速支持
  • 动态 HDR：改进 HDR10+ 检测与元数据处理

开发者变更

HTTP API 调整

  • 授权方式：计划在 10.12 移除旧授权方法（新增测试选项）
  • 播放报告：弃用旧版播放事件接口，改用 ReportPlayback* 系列
  • 新增接口：
    • 获取系统存储信息 (GetSystemStorage)
    • 备份管理 API (BackupApi)

插件开发要求

  • 数据库访问：强制使用 EFCore（不再接受原始 SQL）
  • 实验性功能：支持插件提供自定义数据库访问（API 可能变更）

提示：使用反向代理处理 TLS 是更推荐的方案，未来版本将移除内置 TLS 配置功能。完整更新日志请访问 Jellyfin 官方文档。