habridge/ha-bridge-raspberrypi3

ha-bridge Docker镜像

镜像概述

本项目构建了基于ha-bridge最新主分支版本的Docker镜像，专门针对Raspberry Pi 3平台进行优化。ha-bridge是一款用于智能家居设备协议转换的工具，可实现不同设备间的互联互通。

核心功能与特性

• 基于ha-bridge最新主分支构建，确保功能及时更新
• 支持数据持久化存储，通过卷挂载保留配置信息
• 时间同步功能，通过挂载系统时间文件保持容器内时间准确性
• 支持自定义配置参数，可通过Docker命令行参数灵活调整应用设置

使用场景

适用于在Raspberry Pi 3设备上部署ha-bridge，实现智能家居设备的协议转换与桥接，例如将非原生支持的设备接入Home Assistant等智能家居平台。

使用方法

基本运行命令

以下示例展示如何在Raspberry Pi 3上运行最新版本的ha-bridge容器：

bash
docker run \
     --name ha-bridge \
     --rm \
     --init \
     --detach \
     --net=host \
     --volume=$PWD:/ha-bridge/data \
     --volume=/etc/localtime:/etc/localtime:ro \
     --volume=/etc/timezone:/etc/timezone:ro \
     docker.xuanyuan.run/habridge/ha-bridge-raspberrypi3

参数说明：

• --name ha-bridge：指定容器名称为ha-bridge
• --rm：容器停止后自动删除
• --init：使用init进程管理容器内进程
• --detach：后台运行容器
• --net=host：使用主机网络模式，确保网络访问正常
• --volume=$PWD:/ha-bridge/data：挂载当前目录到容器内数据目录，实现数据持久化
• --volume=/etc/localtime:/etc/localtime:ro：挂载系统本地时间文件（只读）
• --volume=/etc/timezone:/etc/timezone:ro：挂载系统时区文件（只读）

自定义参数运行

如需为ha-bridge设置额外参数，可直接在docker run命令末尾添加：

bash
docker run \
     --name ha-bridge \
     --rm \
     --init \
     --detach \
     --net=host \
     --volume=$PWD:/ha-bridge/data \
     --volume=/etc/localtime:/etc/localtime:ro \
     --volume=/etc/timezone:/etc/timezone:ro \
     docker.xuanyuan.run/habridge/ha-bridge-raspberrypi3 \
     -Dserver.port=8080 \
     -Dsecurity.key=secret

示例参数说明：

• -Dserver.port=8080：指定服务端口为8080
• -Dsecurity.key=secret：设置安全密钥为secret

参考链接

• ha-bridge源代码：https://github.com/bwssytems/ha-bridge
• Dockerfile：https://github.com/escalate/ha-bridge-raspberry-pi-docker/blob/master/Dockerfile