epierre/iss-mdah

MyDomoAtHome nodeJS

Domoticz与Imperihome ISS之间的REST网关，允许查看传感器当前状态并与执行器交互。

!MyDomoAtHome

重要更新

仓库已迁移至https，若收到更新提示，请执行以下操作：

bash
sudo nano /etc/apt/sources.list

将相关行修改为https：

bash
deb https://www.e-nef.com/domoticz/mdah/ /

核心功能与特性

项目目标

提供REST API给ImperiHome ISS，实现传感器状态查看与执行器交互。

已达成目标

• M1：基于Perl Dancer的首个版本
• M2：Node.js重写，提升性能、简化安装
  • 跨平台支持（Linux、Mac OS X、Windows）
  • 无依赖、安装/使用日志
  • Debian包（noarch），支持apt-get自动更新
  • Docker微服务（Docker Hub镜像可用）
  • Synology兼容Docker镜像
  • 支持Domoticz主要传感器/功能类型：
    • 天气和环境传感器
    • 能源传感器（电力、燃气、水）
    • 开关、恒温器
    • 动态房间创建
    • RGB灯（Limitless/Applamp/Hue，取决于Domoticz）
    • 按钮（取决于Imperihome）
• M3：完整图表、灵活房间使用及UI改进
  • 支持按planID的设备
  • 图表显示
  • 带即时能源的开关组
  • 安全码管理
• M4：扩展平台支持（Docker和Synology）
  • 端到端认证
  • HTTPS支持
  • 支持Domoticz华氏温度
  • Synology托管包

支持平台

• 树莓派（RPI）、Odroid、Intel平台测试通过
• Synology NAS
• Docker容器

使用场景与适用范围

适用于家庭自动化系统中需将Domoticz与Imperihome ISS集成的场景，帮助用户通过Imperihome应用监控和控制Domoticz管理的设备，支持多种传感器和执行器，适用于个人家庭或小型办公环境的自动化控制。

安装与使用方法

独立安装（PI、Cubie、Odroid、Intel等）

检查Node.js版本（PI必需）

需Node.js 4.x或更高版本：

bash
sudo dpkg --list | grep nodejs  # 应返回4.x或更高版本

若版本不符，按以下方式安装：

树莓派（RASPBIAN）：

bash
sudo apt-get remove node
wget -q http://www.e-nef.com/domoticz/mdah/nodejs_4.4.2_armhf.deb
sudo dpkg -i nodejs_4.4.2_armhf.deb
wget -q http://www.e-nef.com/domoticz/mdah/npm_2.14.7_armhf.deb
sudo dpkg -i npm_2.14.7_armhf.deb
sudo npm install -g npm@2.x

Debian Buster：

bash
sudo apt-get install nodejs npm

其他Debian/Ubuntu系统：

bash
sudo apt-get remove node
sudo dpkg -r nodejs npm
curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo npm install -g npm@2.x

验证版本：

bash
node --version  # 应显示4.4.x或类似
npm --version   # 应显示2.2.x或类似

安装Debian包（.deb）

1. 添加GPG密钥并编辑源列表：

bash
wget -qO - https://www.e-nef.com/domoticz/mdah/gpg.mykey | sudo apt-key add -
sudo nano /etc/apt/sources.list

2. 添加源：

bash
deb https://www.e-nef.com/domoticz/mdah/ /

3. 更新并安装：

bash
sudo apt-get update
sudo apt-get install MyDomoAtHome  # 不要以root用户安装，使用sudo

4. 编辑配置文件并重启服务：

bash
sudo nano /etc/mydomoathome/config.json  # 填入自定义配置
sudo service mydomoathome restart

Synology安装

1. 在Synology Package Center添加源：http://www.jadahl.com/domoticz_beta_6/
2. 搜索并安装node-mydomoathome包
3. Domoticz默认运行在8084端口，MDAH运行在3002端口
4. 在Domoticz设置→本地网络中添加127.0.0.1

Windows安装

1. 下载并安装Node.js：[***]
2. 下载源码：https://github.com/empierre/MyDomoAtHome%EF%BC%88%E7%BB%BF%E8%89%B2%22Clone or download"按钮）
3. 解压后在命令行中进入目录：

bash
npm install
node mdah.js

4. 配置文件config.json需与mdah.js在同一目录

Docker安装（适用于大型Synology、Xpenology等）

拉取镜像

bash
docker pull epierre/iss-mdah

启动容器

替换your_ip为Domoticz的IP，确保Domoticz授权Docker IP范围：

bash
docker run --name=mdah \
  --env DOMO="http://your_ip:8080" \  # Domoticz的URL
  --env TZ=Europe/Paris \             # 设置时区
  -p 3002:3002 \                      # 端口映射（主机:容器）
  epierre/mdah

管理Docker容器

• 查看运行中容器：docker ps
• 停止容器：docker stop mdah
• 启动容器：docker start mdah

配置说明

配置文件（config.json）

基本格式：

json
{
  "app_name": "MyDomoAtHome",  // 应用名称，多实例时需修改
  "auth": null,                // 访问认证（见下文）
  "tempmode": "C",             // 温度单位（C/F）
  "domoticz": {
    "ssl": false,              // 是否启用SSL连接Domoticz
    "host": "127.0.0.1",       // Domoticz主机IP
    "port": "8080",            // Domoticz端口
    "path": "/",               // Domoticz路径
    "auth": null               // Domoticz认证（见下文）
  },
  "port": "3002",              // 网关端口
  "passcode": ""               // 设备保护码
}

关键配置项说明

• auth：设置网关访问认证，格式：

  json
  "auth": {
    "username": "admin",
    "password": "admin"
  }
  

• domoticz.auth：Domoticz的认证信息，格式同上
• https支持：生成证书后添加配置：

  json
  "https": true,
  "key": "path/to/key.pem",    // 私钥路径
  "cert": "path/to/key-cert.pem" // 证书路径
  

  生成证书命令：

  bash
  openssl genrsa 1024 > key.pem
  openssl req -x509 -new -key key.pem > key-cert.pem
  

安装测试

验证网关运行

在浏览器中访问：http://gateway_ip:gateway_port/，应显示网关主页及相关链接。

验证连通性

• 检查Domoticz可访问（从网关主机）：

  bash
  curl http://domoticz_ip:domoticz_port/json.htm?type=devices&filter=all&used=true&order=Name
  

• 检查网关返回设备列表：

  bash
  curl http://gateway_ip:gateway_port/devices
  

外部网络访问

推荐使用Nginx反向代理，配置示例（添加到Nginx配置文件）：

nginx
location /iss/ {
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $remote_addr;
  proxy_set_header Host $host;
  proxy_pass http://192.168.0.28:3002/;  // 替换为网关IP和端口
  access_log /var/log/nginx/mdah.access.log;
  error_log /var/log/nginx/mdah.error.log;
}

安装Nginx：sudo apt-get install nginx-full

故障排除

• 配置文件语法错误：检查是否有多余逗号（如},}应改为}}）
• Domoticz连接问题：确保Domoticz授权网关IP，可通过curl命令测试连通性
• Docker容器无法访问Domoticz：在Domoticz设置中添加Docker容器所在IP段

支持与反馈

• 问题跟踪：https://github.com/empierre/MyDomoAtHome/issues
• 英文论坛：[***]
• 法文论坛：[***]
• 设备支持问题：提供Domoticz设备JSON数据（访问http://domoticz_ip:8080/json.htm?type=devices&filter=all&used=true&order=Name获取）

常见问题（Q&A）

• Q：如何授权Docker容器访问Domoticz？
  A：在Domoticz设置→本地网络中添加Docker容器的IP或IP段。
• Q：多实例部署如何配置？
  A：修改app_name和port参数，确保端口不冲突。