nrchkb/node-red-homekit

Node-RED-homekit-docker

Node-RED-homekit-docker是一个基于Node-RED的项目，支持HomeKit。它基于https://hub.docker.com/r/nodered/node-red%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%A2%84%E8%A3%85%E4%BA%86%E5%9C%A8Docker%E5%AE%B9%E5%99%A8%E4%B8%AD%E8%BF%90%E8%A1%8CHomeKit%E6%89%80%E9%9C%80%E7%9A%84%E5%BF%85%E8%A6%81%E5%B7%A5%E5%85%B7%E5%92%8Cnpm%E6%A8%A1%E5%9D%97https://www.npmjs.com/package/node-red-contrib-homekit-bridged%E3%80%82

架构

Node-RED-homekit-docker由清单列表支持，这意味着无需为特定架构指定标签。使用不带任何标签或使用latest标签的镜像时，将自动拉取适合当前架构的镜像。

目前Node-RED-homekit支持多种架构：

• amd64：基于Alpine Linux - 适用于大多数桌面计算机（如x64、x86-64、x86_64）
• arm32v6：基于Alpine Linux - （如Raspberry Pi 1和Zero）
• arm32v7：基于Alpine Linux - （如Raspberry Pi 2、3、4）
• arm64v8：基于Alpine Linux - （如Pine64）

注意：当前Docker的架构检测存在bug，可能导致arm32v6架构（如Raspberry Pi Zero或1）检测失败。对于这些设备，目前需要指定arm32v6的完整镜像标签。

快速启动（适用于已运行Docker的用户）

bash
docker run -d --net=host -v <主机路径>:/data --name=node-red-homekit docker.xuanyuan.run/nrchkb/node-red-homekit

命令解析：

docker run                  - 运行容器
-d                          - 后台运行容器并输出容器ID
--net=host                  - 连接到主机网络，这是HomeKit正常工作所必需的
-v <主机路径>:/data         - 持久化容器数据
--name node-red-homekit     - 为容器指定友好的本地名称
nrchkb/node-red-homekit     - 基础镜像

Raspberry Pi（含Docker安装）

以下命令将安装Docker、将用户pi添加到Docker组，并设置容器开机自启。更新命令即将推出（2020年7月开发中）。

bash
sudo apt update && upgrade
cd ~
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker pi
sudo reboot
docker run -d --net=host -v ~/:/data --restart always --name node-red-homekit docker.xuanyuan.run/nrchkb/node-red-homekit

Synology

Synology用户需要添加环境变量DSM_HOSTNAME。

在环境变量选项卡中添加名为DSM_HOSTNAME的新环境变量，其值必须与Synology DSM控制面板->信息中心->服务器名称中显示的服务器名称完全一致，且不包含空格或特殊字符。

bash
docker run it --net=host -v <主机路径>:/data -e DSM_HOSTNAME=<synology主机名> --name=homekit nrchkb/node-red-homekit:<标签>

权限

自Node-RED 1.0起，容器用户为node-red，uid为1000，gid为1000，请确保主机路径<path_on_host>具有相同的uid和gid：

验证命令：

bash
ls -nal <主机路径>

修改命令：

bash
chown -R 1000:1000 <主机路径>

调试

要调试NRCHKB，需在Docker中以调试模式运行node-red，添加-e参数：

-e "DEBUG=NRCHKB*,HAP-NodeJS*"

修改启动命令如下：

bash
docker run it -e "DEBUG=NRCHKB*,HAP-NodeJS*" --net=host -v <主机路径>:/data -e DSM_HOSTNAME=<synology主机名> --name=homekit nrchkb/node-red-homekit:<标签>

官方Node-RED Docker文档

更多详细信息请参考https://github.com/node-red/node-red-docker%E9%A1%B5%E9%9D%A2%E3%80%82