Celeron 2955U 核显 VA-API 硬解与 UxPlay 依赖配置指南

本文档记录基于 Celeron 2955U（Haswell 架构旧款 Intel 核显）在 Debian / Ubuntu 或 Podman 容器环境下，配置 VA-API H.264 硬件解码及 AirPlay 2（UxPlay）环境的完整步骤与验证流程。

一、 安装基础依赖包

1. 核心硬解与 GStreamer 组件

在宿主机或 Podman 容器内运行以下命令，安装 VA-API 驱动、GStreamer 插件及验证工具：

apt-get update && apt-get install -y \
    gstreamer1.0-plugins-bad \
    gstreamer1.0-plugins-good \
    gstreamer1.0-vaapi \
    gstreamer1.0-tools \
    i965-va-driver \
    va-driver-all \
    vainfo

组件说明

• i965-va-driver：2955U 属于旧款 Haswell 架构核显，必须使用经典 i965 驱动，而非较新的 intel-media-driver (iHD)。
• gstreamer1.0-vaapi：GStreamer 调用 VA-API 硬解的核心桥接插件（包含 vaapih264dec）。
• gstreamer1.0-tools：提供 gst-inspect-1.0 等调试和插件检查命令行工具。
• vainfo：VA-API 驱动加载与解码能力检测工具。

二、 配置环境变量与驱动优化

为避免每次运行 VA-API 工具或容器时出现 iHD 驱动初始化失败的报错，需手动指定系统默认使用 i965 驱动。

1. 设置环境变量

临时生效（当前终端）：

export LIBVA_DRIVER_NAME=i965

写入配置文件以永久生效（如 ~/.bashrc 或 /etc/environment）：

echo "export LIBVA_DRIVER_NAME=i965" >> ~/.bashrc

2. Podman / Docker 容器运行参数

在启动容器时传入环境变量及 GPU 设备映射：

podman run -d \
  --name uxplay \
  --net=host \
  --device /dev/dri:/dev/dri \
  -e LIBVA_DRIVER_NAME=i965 \
  ...

三、 验证硬件解码链路

Step 1: 验证 VA-API 驱动加载与硬解能力

运行以下命令检查驱动状态：

vainfo

结果判断

1. 驱动加载：输出信息表明已直接命中 i965_drv_video.so 且返回 0（成功）。
2. 解码支持：输出中需包含以下条目及对应的 VAEntrypointVLD 标志：
3. VAProfileH264ConstrainedBaseline : VAEntrypointVLD
4. VAProfileH264Main : VAEntrypointVLD
5. VAProfileH264High : VAEntrypointVLD

注：iPhone 镜像投屏（AirPlay 2）采用 H.264 (AVC) High Profile 视频流，VAEntrypointVLD 表示 GPU 硬件级别解码功能完整。

Step 2: 验证 GStreamer 框架硬解插件

运行以下命令检查 GStreamer 是否识别到硬件解码器：

gst-inspect-1.0 vaapih264dec

结果判断

若成功返回类似以下信息的 Factory Details，说明 硬件 -> 驱动 -> GStreamer 框架 链路全线贯通：

Factory Details:
  Rank                 primary + 1 (257)
  Long-name            VA-API H264 decoder
  Klass                Codec/Decoder/Video/Hardware
  Description          A VA-API based H264 video decoder

四、 安装并启动 AirPlay 服务依赖（UxPlay 基础）

AirPlay 2 镜像服务（如 UxPlay）依赖网络设备发现机制，需要启动 dbus 和 avahi-daemon：

1. 安装服务包

apt-get update && apt-get install -y avahi-daemon dbus

2. 启动服务

systemctl enable --now dbus avahi-daemon

五、 操作历史流水账记录 (History)

# 1. 安装核心硬解与 GStreamer 插件
apt-get update && apt-get install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-vaapi i965-va-driver va-driver-all vainfo

# 2. 检查硬件驱动（初次检测）
vainfo

# 3. 指定 i965 驱动并复测
export LIBVA_DRIVER_NAME=i965
vainfo

# 4. 检查 GStreamer 插件（提示缺少工具包）
gst-inspect-1.0 vaapih264dec

# 5. 补全 gstreamer1.0-tools 依赖包
apt-get update && apt-get install -y gstreamer1.0-tools

# 6. 设置环境变量并成功验证 GStreamer 硬件解码器
export LIBVA_DRIVER_NAME=i965
gst-inspect-1.0 vaapih264dec

# 7. 安装并启动 AirPlay (mDNS) 网络服务
apt-get update && apt-get install -y avahi-daemon dbus
systemctl enable --now dbus avahi-daemon

你可以通过以下命令禁用开机自启，并顺便彻底清理相关服务与依赖包。

第一步：停止服务并禁用开机自启

运行以下命令，停止正在运行的服务并关掉开机自启：

systemctl disable --now avahi-daemon dbus

说明：

• disable：取消开机自启。
• --now：立即停止后台正在运行的服务。

第二步：卸载无用的后台服务与依赖包（可选）

如果你以后完全不再使用 UxPlay 或 AirPlay 接收功能，可以直接卸载之前安装的软件包，释放系统空间：

1. 卸载网络广播服务（Avahi）

apt-get purge -y avahi-daemon

2. 卸载 GStreamer 及 VA-API 驱动包

apt-get purge -y \
    gstreamer1.0-plugins-bad \
    gstreamer1.0-plugins-good \
    gstreamer1.0-vaapi \
    gstreamer1.0-tools \
    i965-va-driver \
    va-driver-all \
    vainfo

3. 清理残留的孤立无用依赖包

apt-get autoremove --purge -y

注意事项：关于 dbus

• **建议不要卸载 dbus**：dbus 是 Linux 系统中极其基础的进程间通信服务，许多系统核心组件和基础工具都依赖它。只需要执行第一步中的 systemctl disable 即可；如果其他系统组件需要它，系统后续会自动按需唤醒。