Domoticz 镜像文档

概述

Domoticz 是一款功能强大的开源家庭自动化平台，旨在提供智能家居设备的集中监控与控制解决方案。该平台支持多种主流智能设备协议（如Zigbee、Z-Wave、WiFi等），通过直观的Web界面实现设备状态监控、远程控制及自动化规则配置，适用于构建个性化智能家居系统。

核心功能与特性

设备与协议支持

• 兼容多种智能设备类型：灯光、开关、传感器（温度、湿度、运动等）、门锁、温控器、摄像头等
• 支持主流通信协议：Zigbee、Z-Wave、Bluetooth、WiFi、MQTT、HTTP、TCP/IP等
• 可通过插件扩展支持更多设备和协议

自动化与规则引擎

• 基于时间、设备状态或外部事件触发自动化规则
• 支持复杂条件逻辑（如"如果温度高于25℃则开启空调"）
• 支持场景模式（如"离家模式"自动关闭所有灯光并启动安防）

监控与控制

• 实时Web界面监控设备状态，支持桌面/移动设备访问
• 历史数据记录与图表展示（如温度变化曲线、能耗统计）
• 多用户权限管理，支持访客模式

通知与集成

• 支持邮件、短信、Pushbullet、***等通知方式
• 可与第三方服务集成（如Google Home、Amazon Alexa）
• REST API支持自定义集成与扩展

使用场景

• 智能家居集中控制：统一管理灯光、窗帘、家电等设备
• 能源管理：监控能耗并自动调节设备运行以节约能源
• 安防系统：联动门窗传感器、摄像头、报警器，实现异常情况自动报警
• 环境监控：实时监测室内温湿度、空气质量，自动启动调节设备

使用方法

基本运行命令

通过Docker快速启动Domoticz服务：

docker run -d \
  --name domoticz \
  -p 8080:8080 \
  -v /path/to/domoticz/data:/opt/domoticz/userdata \
  -e TZ=Asia/Shanghai \
  --restart unless-stopped \
  domoticz/domoticz

Docker Compose配置

创建docker-compose.yml文件：

version: '3'
services:
  domoticz:
    image: domoticz/domoticz
    container_name: domoticz
    restart: unless-stopped
    ports:
      - "8080:8080"  # Web界面端口
      - "6144:6144"  # HTTPS端口（可选）
      - "1443:1443"  # MQTT端口（可选）
    volumes:
      - ./domoticz/data:/opt/domoticz/userdata  # 数据持久化
      - /dev:/dev  # 访问物理设备（如USB控制器，可选）
    environment:
      - TZ=Asia/Shanghai  # 设置时区
      - LOG_LEVEL=normal  # 日志级别：normal/debug/verbose
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0  # 映射USB设备（如Zigbee控制器，可选）

启动服务：

docker-compose up -d

参数说明

端口映射

数据持久化

• 必须挂载数据目录/opt/domoticz/userdata以保存配置、设备数据和历史记录，路径建议使用绝对路径（如/home/user/domoticz/data）

环境变量

设备映射

若需使用USB设备（如Zigbee/Z-Wave控制器），需通过--device参数或devices配置映射设备路径，例如：/dev/ttyUSB0:/dev/ttyUSB0

访问与配置

1. 启动容器后，通过浏览器访问 http://<主机IP>:8080 进入Domoticz Web界面
2. 首次登录可创建管理员账户（若未通过环境变量设置）
3. 在"设置>硬件"中添加设备控制器（如Zigbee2MQTT、Z-Wave控制器）
4. 添加设备后，可在"设备"页面监控状态或创建自动化规则

注意事项

• 数据目录权限：确保宿主机数据目录权限正确，建议设置权限为777（仅测试）或通过user:group参数指定容器用户
• 设备兼容性：部分设备可能需要安装额外插件或驱动，可通过Web界面"设置>硬件"添加
• 备份策略：定期备份数据目录，防止配置丢失
• 安全建议：生产环境建议启用HTTPS并设置强密码，限制Web界面访问IP范围