heggink/domoticz

Domoticz 家庭自动化系统镜像（含额外应用）

概述

本镜像基于开源家庭自动化平台 Domoticz 构建，集成常用额外应用与工具，旨在提供一站式智能家居解决方案。通过该镜像可快速部署功能完备的家庭自动化系统，支持多协议设备管理、自动化规则配置及扩展功能，无需手动安装依赖组件。

核心功能与特性

基础功能

• 多设备协议支持：兼容 Z-Wave、Zigbee、MQTT、WiFi 等主流智能家居协议
• 集中设备管理：统一监控和控制灯光、温控器、传感器等各类智能设备
• 自动化规则引擎：基于时间、设备状态、环境数据（温度/湿度等）触发自定义动作
• 数据可视化：内置图表工具展示设备运行数据、能耗统计及环境趋势
• 跨平台访问：支持 Web 界面、移动应用（iOS/Android）及 API 接口控制

额外应用增强特性

• 预安装插件库：包含主流设备驱动与扩展模块，减少手动配置
• 系统管理工具：集成网络诊断、日志分析及设备调试组件
• 资源监控：轻量级系统监控工具，实时跟踪 CPU/内存/网络使用情况
• 数据备份工具：自动定时备份配置数据，支持一键恢复

使用场景

• 家庭用户构建个性化智能家居系统，集中管理多品牌智能设备
• 智能家居爱好者快速部署测试环境，验证设备兼容性与自动化逻辑
• 小型办公场所实现基础环境自动化（如照明、空调联动控制）
• 教育或演示场景展示家庭自动化原理与实践应用

使用方法

快速启动（docker run）

bash
docker run -d \
  --name domoticz \
  -p 8080:8080 \
  -v /本地路径/domoticz数据:/config \
  -e TZ=Asia/Shanghai \
  --restart unless-stopped \
  domoticz-extra-apps:latest

参数说明：

• -p 8080:8080：映射 Web 管理界面端口
• -v /本地路径/domoticz数据:/config：持久化配置数据（必选，防止重启丢失设置）
• -e TZ=Asia/Shanghai：设置时区（可选，默认 UTC）
• --restart unless-stopped：异常退出时自动重启

Docker Compose 配置

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  domoticz:
    image: domoticz-extra-apps:latest
    container_name: domoticz
    ports:
      - "8080:8080"  # Web 界面端口
      - "6144:6144"  # 可选，MQTT 服务端口（如需外部访问）
    volumes:
      - ./domoticz_data:/config  # 本地数据目录
    environment:
      - TZ=Asia/Shanghai
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
    devices:
      - /dev/ttyACM0:/dev/ttyACM0  # 映射 USB 设备（如 Z-Wave 控制器）
    restart: unless-stopped

启动命令：docker-compose up -d

环境变量配置

配置说明

Web 界面访问

容器启动后，通过浏览器访问 http://主机IP:8080 进入管理界面。首次登录需完成初始设置：

1. 设置管理员账号密码
2. 配置地理位置（影响日出日落自动化）
3. 添加硬件设备（如控制器、传感器）

设备添加流程

1. 进入 设置 > 硬件 页面
2. 选择设备类型（如 "Z-Wave USB 控制器"）
3. 配置连接参数（如串口路径 /dev/ttyACM0）
4. 点击 添加，系统自动发现并列出设备
5. 在 设备 页面管理设备状态与控制选项

自动化规则创建

1. 进入 设置 > 场景 或 自动化 页面
2. 点击 创建场景，设置触发条件（如 "温度传感器 > 28°C"）
3. 配置执行动作（如 "关闭客厅空调"、"打开风扇"）
4. 保存后规则实时生效，可在 日志 页面查看执行记录

注意事项

• 串口设备（如 Z-Wave/Zigbee 控制器）需通过 --device 参数映射，确保容器访问权限
• 无线网络设备建议使用 host 网络模式（添加 --net=host）以优化通信稳定性
• 定期通过 设置 > 备份 功能导出配置，或通过 /config/backups 目录获取自动备份文件
• 升级镜像前建议停止容器并备份 /config 目录数据