taskinen/home-assistant

Home Assistant Docker镜像

镜像概述和主要用途

本镜像基于https://github.com/home-assistant/home-assistant的分支构建，是一个智能家居控制平台。其核心功能是实现对各类智能家居设备的集中管理和控制，特别添加了对Telldus Tellstick Duo（一款USB连接的通用433 MHz收发器）的支持，方便用户通过433 MHz协议控制相关智能设备。

核心功能和特性

• 基于官方Home Assistant构建，保留其全部智能家居控制功能
• 添加对Telldus Tellstick Duo USB 433 MHz收发器的支持
• 需在特权模式下运行以访问USB设备
• 需挂载USB总线设备以确保Tellstick Duo正常工作
• 支持设备自动发现（需配置host网络模式）

使用场景和适用范围

适用于需要通过433 MHz协议控制智能家居设备的用户，例如：

• 控制433 MHz无线开关、灯光
• 管理433 MHz传感器（如温湿度传感器、门窗传感器）
• 构建基于Home Assistant的智能家居系统，集成433 MHz设备

使用方法和配置说明

Docker Compose部署示例

以下是使用Docker Compose部署的示例配置：

yaml
version: '2'
services:
  hass:
    image: "docker.xuanyuan.run/taskinen/home-assistant"
    volumes:
      - "./some/dir/config:/config"  # 挂载Home Assistant配置目录
      - "./some/dir/tellstick.conf:/etc/tellstick.conf"  # 挂载Tellstick配置文件
    devices:
      - "/dev/bus/usb:/dev/bus/usb"  # 挂载USB总线设备
    ports:
      - "8123:8123"  # Home Assistant Web界面端口
    restart: unless-stopped  # 除非手动停止，否则自动重启
    network_mode: "host"  # 使用主机网络模式以支持设备自动发现
    privileged: true  # 启用特权模式以访问USB设备

Tellstick配置说明

容器内的/etc/tellstick.conf文件用于配置Tellstick软件，需从主机挂载。在主机创建该文件并确保路径与Compose配置一致。

以下是示例配置文件（需根据实际设备自定义）：

user = "root"
group = "root"
device {
  id = 2
  name = "示例灯光"
  controller = 0
  protocol = "arctech"
  model = "selflearning-switch"
  parameters {
    house = "1"
    unit = "2"
  }
}
device {
  id = 3
  name = "另一个示例设备"
  controller = 0
  protocol = "arctech"
  model = "selflearning-switch"
  parameters {
    house = "3"
    unit = "4"
  }
}

关键配置参数说明

• volumes:

  • /config: Home Assistant的核心配置目录，需持久化存储
  • /etc/tellstick.conf: Tellstick收发器的配置文件，需从主机挂载

• devices: /dev/bus/usb:/dev/bus/usb 挂载USB总线，确保容器可访问Telldus Tellstick Duo设备

• network_mode: 设置为host以支持设备自动发现功能

• privileged: 必须设为true，以获取访问USB设备的权限

• ports: 映射8123端口，用于访问Home Assistant Web界面

其他注意事项

• 若不需要设备自动发现，可调整网络模式，但推荐使用host模式以获得最佳兼容性
• Tellstick配置文件中的设备参数（如house、unit）需根据实际设备的学习码进行设置
• 确保主机上的USB设备路径正确，不同系统可能存在差异