seblucas/alpine-homeassistant

Home Assistant Docker镜像

镜像概述

本镜像基于轻量级Alpine Linux构建，提供多架构（amd64、armhf、arm64）支持的Home Assistant智能家居管理平台。通过Docker manifest机制，用户可直接使用主标签无需指定架构后缀，镜像体积小巧且运行高效。

核心功能

• 集成主流品牌智能家居设备（灯光、温控、传感器等）
• 自定义自动化规则（基于时间、设备状态触发场景）
• 实时监控家居设备运行状态
• 支持多用户访问与权限管理
• 丰富插件生态，可按需扩展功能

使用场景

• 家庭智能家居控制中心，统一管理各类智能设备
• 自动化场景配置（如回家自动开灯、离家自动关闭电器）
• 远程监控与控制家居设备状态

配置说明

基础部署

bash
docker run -d --name homeassistant -p 80:8123 docker.xuanyuan.run/seblucas/alpine-homeassistant:latest

数据持久化

推荐映射本地目录保存配置数据：

bash
docker run -d --name homeassistant \
  -p 80:8123 \
  -v /var/opt/docker/homeassistant:/data \
  docker.xuanyuan.run/seblucas/alpine-homeassistant:latest

用户权限设置

容器默认以root运行，可指定uid为1000的用户（需本地存在对应uid用户）：

bash
docker run -it --user 1000 --rm \
  -v /var/opt/docker/homeassistant:/data \
  docker.xuanyuan.run/seblucas/alpine-homeassistant

自定义镜像扩展

可基于本镜像添加插件（如Homekit），示例Dockerfile：

dockerfile
FROM docker.xuanyuan.run/seblucas/alpine-homeassistant:latest

ARG UID="1001"
ARG GUID="1001"
ARG PLUGINS="HAP-python"

RUN apk add --no-cache --virtual=build-dependencies build-base linux-headers python3-dev shadow && \
    egrep -e "${PLUGINS}" /requirements_plugins.txt | grep -v '#' > /tmp/requirements_plugins_filtered.txt && \
    pip3 install --no-cache-dir -r /tmp/requirements_plugins_filtered.txt && \
    usermod -u ${UID} hass && groupmod -g ${GUID} hass && \
    apk del build-dependencies && \
    rm -rf /tmp/* /var/tmp/* /var/cache/apk/*

EXPOSE 51827

ENTRYPOINT ["hass", "--config=/data"]

许可证

本项目采用GPLv2许可证。