Home Assistant Docker镜像

概述

基于Alpine Linux的轻量级Home Assistant Docker镜像，Home Assistant是一款开源智能家居自动化平台。本镜像旨在提供小巧高效的部署方案，支持多架构运行。

支持的架构：

• amd64
• armhf
• arm64

采用镜像清单技术，可直接使用主标签（无需指定架构后缀如amd64-X.X.X）。

使用方法

基本运行

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

配置

数据持久化

建议映射本地目录至容器以保存Home Assistant配置：

-v /var/opt/docker/homeassistant:/data \

运行身份

默认以root用户运行，容器内置uid 1000的用户，可按非特权用户启动（需本地存在uid 1000的用户）：

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

插件管理

基础依赖项列表见Dockerfile，其他插件将由Home Assistant自动下载安装。

自定义镜像

可基于此镜像构建包含额外插件的自定义镜像。示例Dockerfile（添加Homekit插件、修改用户ID及入口命令）：

FROM 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"]

通过修改PLUGINS参数（插件名称以|分隔）添加所需组件。根据插件复杂度，可能无需安装编译器及头文件。

许可协议

本项目采用GPLv2许可协议。