树莓派4环境Docker容器内CEC-Client自动检测失败问题咨询

核心问题定位 #

• 树莓派CEC功能依赖/dev/vchiq硬件设备节点，即使开启特权模式，未将该设备挂载进容器也无法访问
• 容器内libCEC 4.0.4版本与宿主系统的4.0.7版本不兼容，导致适配逻辑匹配失败

具体操作步骤 #

1. 挂载硬件设备节点 #

启动容器时，在原有--privileged、--net=host参数基础上，新增设备挂载参数：

--device /dev/vchiq:/dev/vchiq

如果使用docker-compose部署，对应配置片段如下：

services:
  你的服务名:
    privileged: true
    network_mode: host
    devices:
      - "/dev/vchiq:/dev/vchiq
    # 其余原有配置保持不变

2. 统一libCEC版本 #

选择以下任意一种方案适配版本：

• 方案A（推荐）：更换基础镜像
  将Dockerfile中的基础镜像从arm32v7/python:3.10-buster更换为arm32v7/python:3.10-bookworm，Debian Bookworm源自带的libCEC版本为4.0.7，和宿主系统版本完全匹配，修改基础镜像后重新构建镜像即可。
• 方案B：手动编译安装对应版本
  如果不能更换基础镜像，可在Dockerfile中添加源码编译安装libCEC 4.0.7的逻辑，替换系统源自带的旧版本。

3. 功能验证 #

容器启动完成后，进入容器内部执行cec-client -l命令，输出中可以正常识别到Raspberry Pi的CEC适配器即表示修复成功。

内容的提问来源于stack exchange，提问作者Ash