fphammerle/home-assistant

Docker: Home Assistant 🏡🐳

镜像概述和主要用途

本镜像为https://github.com/home-assistant/home-assistant官方Docker镜像的简单包装，基于https://hub.docker.com/r/homeassistant/home-assistant构建，旨在提供更安全的运行环境。

核心功能和特性

• 移除权限位：删除所有文件的setuid和setgid权限位，降低权限滥用风险
• 非特权用户运行：以非特权用户（而非root）运行Home Assistant，增强容器安全性

使用场景和适用范围

适用于需要在Docker环境中安全部署Home Assistant家庭自动化系统的场景，尤其适合对容器安全性有较高要求的用户。

使用方法和配置说明

基本部署命令

sh
$ sudo docker run --name home_assistant \
    -v home_assistant_config:/config:rw \
    -p 8123:8123 \
    --read-only --tmpfs /home/hass/.config/async_dns:mode=1777,size=4k \
    --security-opt=no-new-privileges --cap-drop=all \
    --restart unless-stopped \
    fphammerle/home-assistant

挂载Z-Wave加密狗

1. 创建udev规则文件：

sh
$ cat /etc/udev/rules.d/zwave.rules
ACTION=="add", SUBSYSTEM=="tty", ATTRS{idVendor}=="10c4", ATTRS{idProduct}=="ea60", SYMLINK+="zwave-dongle"

2. 检查设备权限后，在启动容器时添加设备挂载：

sh
$ sudo docker run --device /dev/zwave-dongle:/dev/zwave-dongle …

挂载/proc/device-tree

Adafruit-DHT库需要访问/proc/device-tree（实际为/sys/firmware/devicetree/base的符号链接），但Docker会屏蔽/sys/firmware目录。解决方法如下：

1. 先启动容器（不显式挂载devicetree）：

sh
$ sudo docker run --name home_assistant …

2. 卸载屏蔽的tmpfs：

sh
$ sudo nsenter --target $(sudo docker inspect --format={{.State.Pid}} home_assistant) --mount umount /sys/firmware

参考链接

• 官方安装指南：https://www.home-assistant.io/docs/installation/docker/
• Dockerfile：[***]
• 签名镜像哈希：https://github.com/fphammerle/docker-home-assistant/tags