kimdiallo/homebridge

适用于树莓派的Homebridge Docker镜像集合

镜像概述

本镜像集合旨在提供一种简单方式，运行基于https://github.com/nfarina/homebridge%E5%92%8CDocker%E7%9A%84%E7%A8%B3%E5%AE%9A%E3%80%81%E8%BD%BB%E9%87%8F%E6%99%BA%E8%83%BD%E5%AE%B6%E5%B1%85%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%EF%BC%8C%E6%94%AF%E6%8C%81%E9%80%9A%E8%BF%87Siri%E5%92%8CApple HomeKit控制、自动化和监控家居设备。集合包含从npmjs.com精选的插件，所有镜像均在不同物理树莓派模型上构建并测试。通过Docker可为每个插件运行独立桥接，保持配置清晰简洁，且单个容器错误不会影响其他容器，确保整体稳定高效。

核心功能

1. 支持通过Siri和Apple HomeKit控制家居设备
2. 提供精选Homebridge插件的独立Docker镜像
3. 容器化部署确保各插件隔离运行，提升稳定性
4. 适配树莓派硬件环境，经过真机测试

使用场景

• 树莓派用户构建智能家居系统
• 需要通过HomeKit统一管理不同品牌智能设备的场景
• 希望通过容器化方式简化Homebridge插件部署与维护

配置说明

硬件要求

• 树莓派（任意型号）

软件要求

• 已安装并运行Docker环境
  推荐使用HypriotOS，这是一款基于Debian的轻量操作系统，针对Docker优化，提供最新Docker版本和丰富功能。

使用步骤

1. 确定镜像标签

镜像基础名称为kimdiallo/homebridge，标签为npm插件名称去掉homebridge-前缀。
语法：<image>:<PLUGIN>
例如，若需运行homebridge-config-ui-x插件，标签为config-ui-x，拉取命令：

bash
docker pull kimdiallo/homebridge:config-ui-x

2. 准备根目录

创建插件对应的根目录：

bash
mkdir /opt/homebridge/<plugin>

在该目录下放置插件npm页面要求的config.json文件（具体内容参考插件npm页面）。

3. 运行镜像

将创建的目录作为卷挂载运行：

bash
docker run -d \
  --name homebridge-<plugin> \
  -v /opt/homebridge/<plugin>:/root/ \
  --network host \
  --restart always \
  kimdiallo/homebridge:<tag>

4. 连接HomeKit

首次运行需扫描日志中的***，将桥接添加到HomeKit：

bash
docker logs homebridge-<plugin>

使用iPhone扫描日志中的***即可完成集成。