Jellyfin Web 在 GNOME Web 浏览器中的 H.265 兼容性问题分析

在多媒体流媒体平台 Jellyfin 的 Web 客户端中，存在一个关于 H.265 视频编解码器支持的兼容性问题。当用户通过 GNOME Web（即 Epiphany 浏览器）访问 Jellyfin 服务时，系统会错误地认为浏览器不支持 H.265 编码，从而导致不必要的视频转码过程。

问题现象

用户在 Arch Linux 系统上使用 GNOME Web 47.0 浏览器访问 Jellyfin 10.9.11 版本时，发现所有 H.265 编码的视频内容都会被强制转码。然而，通过独立的测试工具验证，同一系统环境下的 GNOME Web 浏览器实际上能够正常播放 H.265 编码的媒体内容。

技术背景

H.265（也称为 HEVC）是一种高效视频编码标准，相比 H.264 能在相同画质下显著降低码率。在现代浏览器中，对 H.265 的支持通常依赖于以下因素：

1. 浏览器自身的解码能力
2. 底层媒体框架（如 GStreamer）的支持
3. 硬件加速能力（如 VAAPI）

问题根源

经过分析，这个问题源于 Jellyfin Web 客户端采用了基于浏览器用户代理（User-Agent）的检测机制，而非实际的编解码能力检测。具体表现为：

1. Jellyfin 维护了一个支持 H.265 的浏览器白名单
2. GNOME Web 不在这个白名单中
3. 即使用户系统实际具备 H.265 解码能力，也会被强制转码

临时解决方案

目前用户可以采用以下临时解决方案：

1. 修改 GNOME Web 的用户代理字符串，伪装成 Safari 浏览器
2. 通过 dconf 设置工具修改 /org/gnome/epiphany/web/user-agent 值为 Safari 的用户代理字符串

理想解决方案

从技术角度，更合理的解决方案应该包括：

1. 实现基于实际能力检测的机制，而非依赖用户代理嗅探
2. 可以考虑在客户端首次运行时进行简单的编解码测试
3. 提供用户可覆盖的配置选项，允许手动指定支持的编解码器

系统兼容性影响

这个问题突显了跨平台媒体播放兼容性挑战。虽然 GNOME Web 基于 WebKit 引擎，理论上应该具备与 Safari 相似的媒体支持能力，但由于浏览器识别机制的限制，导致了不必要的转码开销。

未来展望

随着 Web 平台媒体能力的不断发展，建议 Jellyfin 开发团队考虑：

1. 采用更可靠的媒体能力检测方法
2. 减少对用户代理字符串的依赖
3. 提供更灵活的编解码器配置选项

这个问题虽然可以通过用户代理伪装暂时解决，但从长远来看，需要更根本的解决方案来提升跨浏览器兼容性和用户体验。