跳至主内容

Jellyfin 10.9.0

· 1 分钟阅读
Joshua Boniface
Joshua Boniface
Project Leader
非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

我们很高兴地宣布 Jellyfin 最新稳定版本 10.9.0 正式发布！

这个主要版本带来了众多新功能、改进和错误修复，将全面提升您的 Jellyfin 使用体验。

您现在可以随时升级 Jellyfin 实例，但请务必阅读下文了解完整的新特性和变更内容，其中包括一些非常重要的发布说明。对于参与测试不稳定版本的贡献者，我们表示衷心感谢，您现在可以切换回稳定版本仓库并强制重新安装/拉取最新版本。

祝您观影愉快！

—— Joshua

重要发布说明/破坏性变更​

在深入了解具体变更之前，管理员用户需要注意 10.9.0 版本的几个关键变化。

  • 一如既往地，升级前请务必备份您的 Jellyfin 数据和配置目录。在主要版本更新中，您可能会遇到需要回退的 bug，此时必须通过备份恢复。

  • Ubuntu 用户：10.9.0 版本起我们不再支持非 LTS 的 Ubuntu 版本。也就是说，我们仅为 20.04 LTS、22.04 LTS 和 24.04 LTS 构建了 10.9.0 软件包，且未来也不会为非 LTS 版本提供构建。原因说明请参阅我们之前的博客文章。如果您使用其他版本，请升级至 24.04 LTS 或改用 Docker 容器。

  • Fedora/CentOS/RHEL 等用户：我们已停止官方 RPM 软件包支持，建议切换到第三方 RPMFusion 仓库或使用 Docker 容器。长期以来，对 RHEL 系发行版的支持一直是我们面临的主要痛点，我们认为交由 RPMFusion 社区处理更符合项目长远利益，这与 Arch、Gentoo 等发行版的打包方式类似。详情请见我们之前的博客文章。

  • Docker 用户：除 Docker Hub 外，我们现在新增 GitHub 容器注册表 (GHCR) 作为替代镜像源。您可以通过 ghcr.io/jellyfin/jellyfin:latest 这类 URI 从新注册表拉取镜像。请放心，我们没有停止 Docker Hub 服务的计划，但提供双选项能为用户带来更多选择和灵活性。

  • Docker 用户：如果首页加载遇到问题，您可能需要移除容器中的 DOTNET_SYSTEM_GLOBALIZATION_INVARIANT 环境变量，因为该设置在 Jellyfin 10.9.0 中已失效。更多细节请参考问题 11533 和问题 11528。

  • Nginx 反向代理用户：如果您的 nginx 配置中存在以 location ~ ^/web/$ { 开头并带有注释 # location block for /web - This is purely for aesthetics [...] 的代码块，请移除该部分，否则在 10.9.z 版本中可能导致间歇性的 404 错误和/或性能下降。

重大变更​

这个版本历经两年多的开发打磨，我们非常高兴终于能将它交付给您。漫长的开发周期意味着更新日志内容非常丰富——自2022年首次发布10.8.0版本以来，我们已将超过1100个拉取请求合并到master分支。本节将按系统功能模块划分，详细介绍所有重大变更。除了这些核心改进外，还有数百个小型错误修复、体验优化及其他次要调整未在此处提及，如需查看完整列表，请访问核心服务器与Web界面的GitHub发布页面。

通用改进​

  • 现已支持"trickplay"（实时视频预览）功能。启用后拖动进度条时，您将看到对应时间点的实时画面预览。请注意该功能需客户端明确支持，具体可用时间取决于您使用的客户端。

  • 网页重定向处理更可靠，显著降低界面中出现失效页面的概率。建议强制刷新浏览器缓存或清除Jellyfin实例的缓存以获得完整优化效果。

  • DLNA支持已转为插件实现，并从核心服务器移除。这带来三大优势：一是可独立于服务器进行更新；二是默认禁用状态，仅当用户显式安装插件时启用；三是通过前两点降低了DLNA相关的安全风险。如需使用DLNA功能，请在升级后安装对应插件。

  • 图片库现已支持AVIF和WEBP格式图像。

  • 搜索功能现已支持标签筛选，可通过标签进行精准检索。

  • Web播放器现支持同时显示多条字幕轨道（最多两条，分主/副轨道）。

  • 管理控制台界面全面改版，显著提升操作效率与选项查找便捷性。

API与安全性​

  • 所有API端点现均返回标准化状态码，确保无需额外解析即可准确判断返回结果。

  • 家长分级控制系统全面升级，包含更严格的执行机制、可继承的分级设置等多项改进。

  • 直播电视与媒体库合集权限现支持独立配置，可针对不同用户进行精细化控制。

  • 简易密码（PIN）功能因存在重大安全风险（尤其对管理员账户）已被移除；快速连接（QuickConnect）登录方式仍可正常使用。

  • 用户权限管理系统完成统一并修复多个漏洞，显著提升服务器面对非可信用户时的安全性。

核心服务器与网络​

  • 运行环境升级至.NET 8（最新长期支持版），通过底层优化助力代码库精简与整体性能提升。

  • 最低FFmpeg版本要求从4.0提升至4.4以支持新特性。使用Jellyfin定制FFmpeg构建（Docker容器/.deb包/Debuntu源/Windows安装包）的用户已预装FFmpeg 6.0.1不受影响，此变更主要影响其他平台。

  • 服务器现支持进程内重启，取代原有的restart.sh临时方案。这使得插件安装等操作更可靠，并确保跨平台/安装方式的一致重启体验。

  • 上传图片现经过更严格的安全校验，有效修复该功能存在的多个安全漏洞。

  • 后端SQLite数据库现支持连接池技术，显著提升数据库操作性能。

  • 支持 HappyEyeballs 引擎，显著提升双栈 IPv4/IPv6 网络兼容性。

  • 改进 IP 绑定处理机制，全面遵循相关设置（含 DLNA 和 SSDP）。

软件打包​

  • Debian/Ubuntu 系统的新安装中，jellyfin 服务用户将自动加入 render 和 video 用户组，优化硬件加速的初始配置体验。

  • 软件打包现已通过新 CI 系统实现统一。普通用户不会察觉变化，但这极大优化了构建流程；若需自行构建软件包，请参考新打包仓库的更新流程。

转码与 FFmpeg​

  • --ffmpeg 命令行参数现作为主路径设置方式，encoding.xml 的 FFmpeg 路径配置已弃用。所有官方打包版本将恢复默认设置（升级前显式配置的除外）。

  • 多项音频优化：HLS 引擎支持 Opus/FLAC/ALAC 编解码器；增强 DTS/TrueHD 音频流转码处理；新增编解码器强制策略；更精准比特率计算；新增音频归一化功能；支持立体声下混算法选择。

  • FFmpeg 分段文件现可在客户端请求后自动删除，显著减少转码临时目录空间占用。此可选功能默认关闭，可在转码设置中启用。

  • 支持直接流式播放 DVD/蓝光数据文件夹（优于 ISO 镜像）。

  • 支持 AV1 硬件与软件编码。

  • 支持通过 MPP 实现 RK3588 硬件加速。

  • 支持基于 Vulkan 的色调映射（搭配 AMD VA-API）。

  • 支持 Apple 系统（Apple Silicon/Intel）的完整硬件加速（此前仅部分支持）。

  • 支持杜比视界（Dolby Vision）播放混流。

扫描、媒体库与播放列表管理​

扫描、媒体库与播放列表管理​

  • 支持扫描并显示本地歌词文件（内嵌/外部文件；互联网歌词搜索功能计划在 10.10 推出）。

  • 现可从 NFO 文件解析季名称。

  • 支持听障辅助字幕（sdh/hi./cc）。

  • 播放列表现可设为私密

    • 用户播放列表默认设为私密
    • 播放列表共享功能正在开发中

  • 无效项目将自动从播放列表移除。

投射功能​

  • 增强本地网络检测能力

  • 连接稳定性优化

  • 支持自托管投射接收器

我们正在招募投射接收器贡献者。该应用在使用"Google Cast"功能时会加载至电视端。如有兴趣请联系我们。

下个版本规划​

随着之前介绍的持续集成改进措施落地，我们确信这将是最后一个"超长"发布周期。下一个主要版本（10.10.0）计划最迟在6个月内发布，预计于10月左右推出。加快发布节奏有助于缓解大型版本带来的问题，例如新功能/翻译需长期等待稳定版本，同时能减少每个主要版本的重大缺陷数量，从而简化升级流程。但这需要所有人的共同努力——2023年10月我们曾发起开发者招募并收获热烈响应，但这绝非一次性活动。我们比以往任何时候都更需要贡献者，尤其在Web前端领域协助实现计划中的设计变更。若您对此感兴趣，欢迎随时联系我们，我们将全力协助您快速上手。

结语​

谨向所有为10.9.0版本做出贡献的伙伴致以诚挚谢意。GitHub统计显示两个代码仓库共有超百位贡献者参与——没有你们的付出，Jellyfin不可能取得今日成就。这个由社区共同构筑的项目令我们深感自豪，期待未来持续成为自由开源媒体系统的首选解决方案。祝您观影愉快！