tjjp/garage-pi-v3

车库门控制Web服务器Docker镜像

镜像概述

本Docker镜像用于创建一个轻量级Web服务器，专门用于控制车库门的开关操作。通过该镜像部署的服务可提供Web界面或API接口，实现对车库门的远程或本地控制，适用于家庭自动化场景。

核心功能与特性

• 轻量级设计：基于小型Web服务器构建，资源占用低，部署便捷
• 车库门控制：支持车库门的开启、关闭及状态查询功能
• 容器化部署：通过Docker容器化方式运行，环境隔离性好，易于维护和迁移

使用场景与适用范围

• 家庭自动化系统中需要远程控制车库门的场景
• 希望通过Web界面或API接口管理车库门状态的用户
• 需要快速部署车库门控制服务的小型家庭或个人用户

使用方法与配置说明

基本部署命令

使用以下命令快速启动容器：

bash
docker run -d -p 8080:80 --name garage-door-controller [镜像名称]

• -p 8080:80：将容器内Web服务器端口（默认80）映射到主机的8080端口
• --name garage-door-controller：指定容器名称为garage-door-controller

环境变量配置

可通过环境变量自定义服务参数（具体参数需参考镜像完整文档）：

bash
docker run -d -p 8080:80 \
  -e PORT=80 \
  -e DOOR_PIN=18 \
  --name garage-door-controller [镜像名称]

• PORT：容器内Web服务端口（默认80）
• DOOR_PIN：连接车库门控制器的GPIO引脚（如适用）

访问服务

容器启动后，通过浏览器访问 http://[主机IP]:8080 即可打开车库门控制界面，进行开关操作及状态查看。

注意事项

• 确保主机具备控制车库门所需的硬件接口（如GPIO、继电器等）
• 根据实际硬件连接情况调整环境变量配置
• 生产环境建议配置身份验证以保障安全性