jellyfin 硬解

### 如何在 Jellyfin 中配置硬件解码

为了使 Jellyfin 能够利用硬件加速进行视频解码，需要确保操作系统和 Docker 容器能够访问 GPU 设备，并且 FFmpeg 支持特定于硬件的编码/解码选项。

#### 配置 Docker 启动参数以允许设备共享
当启动 Jellyfin 的 Docker 实例时，应当通过 `--device` 参数来挂载必要的图形处理单元 (GPU) 文件节点到容器内部。这使得应用程序可以调用底层硬件资源完成媒体流的高效处理[^3]：

docker run -d --restart=always \
    --name=jellyfin \
    -p 32778:8096 -p 32770:8920 \
    -v /share/container/jellyfin:/config \
    -v /share/homes/admin/gxf/movie-jellyfin:/media \
    --device /dev/dri/renderD128:/dev/dri/renderD128 \
    --device /dev/dri/card0:/dev/dri/card0 \
    linuxserver/jellyfin:latest

上述命令中的 `/dev/dri/*` 是 Linux 下表示 Direct Rendering Manager(DRM) 接口路径的例子；对于不同架构或平台可能有所不同，请根据实际情况调整这些路径设置。

#### 修改 FFmpeg 编译选项加入硬件编解码支持
如果打算让 Jellyfin 使用更广泛的硬件特性，则需重新构建带有额外标志位的自定义版本 FFmpeg 库。例如，在 Raspberry Pi 上可以通过指定如下选项开启 OpenMAX IL API 来获得更好的性能表现[^2]:

./configure ... \
    --enable-omx \
    --enable-omx-rpi \
    --enable-hwaccel=h264_mmal \
    ...
make && make install

请注意，具体的编译指令会依据目标系统的差异而变化，以上仅作为示例展示如何向 FFmpeg 添加对某些 SoC 内建多媒体引擎的支持功能。

#### 更新 Jellyfin 设置启用硬件加速
最后一步是在 Web UI 或者配置文件里激活相应的开关项以便充分利用已安装好的驱动程序和服务。通常情况下，默认安装包已经预设了一些常见的优化方案可供选择，但对于特殊需求来说还是建议手动编辑 JSON 格式的偏好设定文档[^1]。

一旦完成了上述操作并重启服务之后，应该能够在播放记录里面看到有关 H.264/H.265 等格式被成功卸载至专用芯片的信息反馈。