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服务：

bash
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文件：

yaml
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控制器，可选）

启动服务：

bash
docker-compose up -d

参数说明

端口映射

端口	用途
8080	Web管理界面（HTTP）
6144	Web管理界面（HTTPS，需配置）
1443	MQTT服务器端口（可选）

数据持久化

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

环境变量

变量名	说明	示例值
TZ	系统时区	Asia/Shanghai
LOG_LEVEL	日志输出级别	normal/debug
USERNAME	可选，设置默认管理员用户名	admin
PASSWORD	可选，设置默认管理员密码	securepassword