taskinen/home-assistant

Home Assistant Docker镜像

镜像概述和主要用途

本镜像基于https://github.com/home-assistant/home-assistant%E7%9A%84%E5%88%86%E6%94%AF%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%98%AF%E4%B8%80%E4%B8%AA%E6%99%BA%E8%83%BD%E5%AE%B6%E5%B1%85%E6%8E%A7%E5%88%B6%E5%B9%B3%E5%8F%B0%E3%80%82%E5%85%B6%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E6%98%AF%E5%AE%9E%E7%8E%B0%E5%AF%B9%E5%90%84%E7%B1%BB%E6%99%BA%E8%83%BD%E5%AE%B6%E5%B1%85%E8%AE%BE%E5%A4%87%E7%9A%84%E9%9B%86%E4%B8%AD%E7%AE%A1%E7%90%86%E5%92%8C%E6%8E%A7%E5%88%B6%EF%BC%8C%E7%89%B9%E5%88%AB%E6%B7%BB%E5%8A%A0%E4%BA%86%E5%AF%B9Telldus 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: "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设备路径正确，不同系统可能存在差异