树莓派5中Docker容器使用gpiozero控制GPIO失败问题

核心问题分析 #

从错误日志可以看出，容器内的gpiozero尝试加载多个Pin Factory均失败：

• lgpio：pip安装的纯Python版本不兼容树莓派5硬件接口，缺失SET_BIAS_DISABLE属性
• rpigpio：未安装RPi.GPIO依赖包
• pigpio：容器内localhost指向自身网络空间，无法连接宿主机的pigpiod服务
• native：容器内无法识别GPIO基地址，sysfs权限或路径不匹配

解决方案 #

方案1：使用RPi.GPIO作为Pin Factory #

这是最直接的兼容方案，利用原生RPi.GPIO驱动控制GPIO。

修改Dockerfile

FROM python:3.11
COPY blink.py ./
# 安装gpiozero和官方RPi.GPIO依赖
RUN pip install gpiozero RPi.GPIO
CMD ["python", "blink.py"]

运行容器命令

docker run --privileged -v /dev/gpiomem:/dev/gpiomem -v /sys/class/gpio:/sys/class/gpio blinker:latest

可选：强制指定Pin Factory避免自动 fallback

docker run --privileged -e PIN_FACTORY=rpigpio -v /dev/gpiomem:/dev/gpiomem -v /sys/class/gpio:/sys/class/gpio blinker:latest

方案2：连接宿主机的pigpiod服务 #

如果需要使用pigpio功能，需要让容器访问宿主机的pigpiod服务。

步骤1：修改宿主机pigpiod启动参数

允许远程连接（默认仅localhost）：

sudo systemctl stop pigpiod
sudo pigpiod -n 0.0.0.0
# 设置开机自启
sudo systemctl edit pigpiod
# 在编辑器中添加：
# [Service]
# ExecStart=
# ExecStart=/usr/bin/pigpiod -n 0.0.0.0
sudo systemctl daemon-reload
sudo systemctl enable --now pigpiod

步骤2：运行容器（二选一）

• 共享宿主机网络：

docker run --privileged --network host -v /dev:/dev -v /sys:/sys blinker:latest

• 指定宿主机IP（Docker默认网关通常为172.17.0.1）：

docker run --privileged -e PIGPIO_ADDR=172.17.0.1 -v /dev:/dev -v /sys:/sys blinker:latest

方案3：使用树莓派专属镜像修复lgpio问题 #

通用Python镜像缺少树莓派硬件依赖，改用官方树莓派Python镜像安装原生lgpio库。

修改Dockerfile

FROM raspberrypi/python:3.11
COPY blink.py ./
RUN pip install gpiozero lgpio
CMD ["python", "blink.py"]

运行容器命令

docker run --privileged --device /dev/gpiochip4 -v /sys:/sys blinker:latest

可选：强制指定lgpio作为Pin Factory

docker run --privileged -e PIN_FACTORY=lgpio --device /dev/gpiochip4 -v /sys:/sys blinker:latest

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