zinen2/alpine-pigpiod

alpine-pigpiod Docker镜像文档

!https://github.com/zinen/docker-alpine-pigpiod/workflows/Docker%20hub%20auto%20publish%20image/badge.svg

镜像概述和主要用途

本Docker镜像包含pigpiod，基于Alpine Linux构建，体积仅约6MB。主要用于在树莓派上控制通用输入输出（GPIO），可与Node-RED配合使用，通过安装node-red-node-pi-gpiod包实现GPIO访问。

核心功能和特性

• 轻量级：基于Alpine Linux，镜像体积约6MB，资源占用低
• GPIO控制：集成pigpiod守护进程，提供树莓派GPIO控制能力
• 跨型号支持：适配多种树莓派型号，包括1、Zero、2、3、4等
• 自动更新：当pigpio发布新版本时，镜像会自动构建更新

使用场景和适用范围

• 树莓派GPIO远程控制应用开发
• 与Node-RED等自动化平台集成，实现GPIO编程控制
• 需要通过网络（端口8888）远程访问树莓派GPIO的场景

使用方法和配置说明

基本使用命令

32位系统：

bash
docker run -it -p 8888:8888 --device /dev/gpiochip0 zinen2/alpine-pigpiod

64位系统或遇到访问权限问题：

bash
docker run -it -p 8888:8888 --privileged zinen2/alpine-pigpiod

注意：容器必须在树莓派本地运行，其他设备可通过网络端口8888访问GPIO。

关于pigpiod

pigpiod是一个Linux守护进程，用于启动pigpio库。pigpio是树莓派专用的GPIO控制库，提供丰富的GPIO操作接口，而pigpiod则允许通过网络远程访问这些功能。

镜像标签选择

默认情况下无需指定标签，使用latest即可，Docker会自动选择匹配当前架构的镜像。若自动选择失败，可使用以下标签：

*若在您的硬件上测试成功，请通过issue或PR反馈以更新此列表。

部分访问问题可通过特权模式解决：

bash
docker run -it -p 8888:8888 --privileged zinen2/alpine-pigpiod

特定版本获取

可通过指定标签拉取特定pigpio版本，例如拉取版本78：

bash
docker pull zinen2/alpine-pigpiod:pigpio-v78

完整标签列表见https://hub.docker.com/repository/docker/zinen2/alpine-pigpiod/tags%E3%80%82

镜像更新机制

当https://github.com/joan2937/pigpio/releases时，镜像会自动触发构建流程，确保用户能获取最新版本。

致谢

start.sh脚本主要借鉴自https://github.com/janvda/balena-node-red%E3%80%82