aietes/homegear

Homegear树莓派镜像文档

镜像概述

本镜像为树莓派平台提供Homegear智能家居中枢系统的容器化部署方案。Homegear是一款开源的智能家居集成平台，支持多种智能家居协议（如Homematic、Z-Wave、KNX等），可实现不同品牌智能设备的统一管理与控制。本镜像特别针对树莓派硬件优化，并以特权模式运行容器，确保对硬件资源的访问能力。

核心功能与特性

• 树莓派优化：专为树莓派架构构建，确保在ARM平台上的稳定运行
• 特权模式运行：容器以特权模式启动，支持访问树莓派的GPIO、串口等硬件资源，满足智能家居设备通信需求
• 完整Homegear功能：包含Homegear核心服务及标准协议支持
• 容器化优势：简化部署流程，便于版本管理和环境隔离

使用场景

• 树莓派智能家居控制中心搭建
• 家庭自动化系统部署
• 多品牌智能设备集成与统一管理
• 智能家居应用开发与测试环境

使用方法

基本运行命令

bash
docker run -d \
  --name homegear-rpi \
  --privileged \
  --restart always \
  -p 2001:2001 \  # Homegear管理端口
  -p 2002:2002 \  # Homegear WebSocket端口
  -v /path/to/homegear/config:/etc/homegear \  # 配置文件持久化
  -v /path/to/homegear/data:/var/lib/homegear \  # 数据持久化
  homegear-rpi

关键参数说明

• --privileged：必须参数，授予容器访问主机硬件的权限
• 端口映射：根据需要映射Homegear服务端口（默认管理端口2001，WebSocket端口2002）
• 数据卷挂载：建议挂载配置目录(/etc/homegear)和数据目录(/var/lib/homegear)以实现数据持久化

配置说明

容器启动后，可通过以下方式进行配置：

1. 编辑挂载的配置目录中的homegear.conf文件调整系统参数
2. 通过Web界面访问http://<树莓派IP>:2001进行可视化配置
3. 使用docker exec -it homegear-rpi homegearcli命令行工具进行配置管理

日志查看

bash
docker logs -f homegear-rpi

停止与重启

bash
# 停止容器
docker stop homegear-rpi

# 重启容器
docker restart homegear-rpi

注意事项

• 确保树莓派已安装Docker环境
• 特权模式可能带来安全风险，仅在可信环境中使用
• 首次启动需等待Homegear初始化，可能需要几分钟时间
• 若使用Z-Wave、Zigbee等无线模块，需确保容器可访问相应USB设备（可通过--device参数指定具体设备）