如何在Docker镜像的/sys/class目录下获取GPIO节点？

核心原因 #

你在Windows Docker Desktop上运行容器时，容器实际运行在Windows的虚拟机（WSL2或Hyper-V）中，该虚拟机的内核是针对x86/amd64架构的通用Linux内核，并没有BeagleBone Black专用的GPIO驱动模块。而/sys/class/gpio目录是由硬件对应的内核驱动创建的，因此在Windows环境下的容器中自然无法看到该目录。

解决方案 #

1. 在BeagleBone Black硬件上直接运行容器

这是最直接的解决方式：

• 在BeagleBone Black上安装适配ARM架构的Docker版本。
• 将Dockerfile和项目代码同步到BeagleBone设备，构建镜像后执行docker run -it --privileged testgpio启动容器。此时容器共享BeagleBone的内核，GPIO驱动已加载，/sys/class/gpio会正常显示。

2. 开发阶段的替代方案（Windows开发+BeagleBone部署）

若需在Windows上完成开发再部署到BeagleBone：

• 远程开发：使用VSCode的Remote-SSH插件连接到BeagleBone设备，直接在远程环境中编写代码、构建并测试容器。
• 交叉编译：在Windows上针对ARM架构交叉编译依赖GPIO的应用程序，将编译好的二进制文件放入镜像后，再到BeagleBone上运行容器。

3. BeagleBone本地运行时的额外检查

若已在BeagleBone上运行容器但仍无法看到GPIO：

• 确认主机内核已加载GPIO驱动模块：执行lsmod | grep gpio查看相关模块是否存在。
• 若驱动未加载，可手动加载（例如modprobe gpio_keys，具体模块名需根据BeagleBone的内核版本调整）。
• 尝试显式挂载/sys/class/gpio到容器：

  docker run -it --privileged -v /sys/class/gpio:/sys/class/gpio testgpio
  

补充说明 #

你安装的libgpiod仅为用户空间的GPIO操作库，它依赖内核提供的/sys/class/gpio或字符设备接口才能工作。没有内核驱动的支持，仅安装这些库无法让GPIO目录出现。

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